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I . INTRODUCTION 



The ATARI (R) 800™ and ATARI 400™ Personal Computer Systems 
contain a 6502 microprocessor, 4 1/0 chips, operating system ROM, expandable 
RAM, and several MSI chips for address decoding and data bus buffering. 
This manual is primarily intended to describe the 4 1/0 chips in sufficent 
detail to allow experienced programmers to create assembly language programs, 
such as video games. All four Input /Output chips are controlled by the 
microprocessor by writing directly into their registers which are decoded 
to exist in microprocessor memory space just as RAM does. These I/O chips 
can also be interrogated by the microprocessor by reading similar registers. 

Many registers are write only and cannot be read after they are 
written. In some cases, reading from the same address gives the value 
contained in a separate read only register. Some write only registers are 
strobes. No data bits are needed in this case since the presence of the 
address on the bus is what triggers the requested action. The usual 
convention is to use the STA (Store Accumulator) instruction for such 
registers. For example, STA WSYNC performs the wait for Sync function. 
STX (Store X) or STY (Store Y) would work just as well. In BASIC, a POKE 
could be used (the data could be anything). Reading a register is accomp- 
lished by using any of the load instructions (LDA, LDX etc.). In BASIC 
a PEEK would be used. When the hardware register names are defined in an 
equate list, the programmer can refer to the registers by name rather than 
using the addresses directly. 

It is really not necessary for the programmer to know which 
I/O functions are performed by which of the 4 chips, however it 
does help in learning these functions. 

This manual should be used in conjunction with the Operating 
System (OS) Manual, a 6502 programming manual, and the ATARI 400/800 
Basic Reference Manual . 

CHIP NAME FUNCTION 

ANTIC DMA (Direct Memory Access) control 

NMI (Non-Maskable Interrupt) control 
Vertical and Horizontal fine scrolling 
Light pen position registers 
Vertical line counter 
WSYNC (wait for horizontal sync) 

CTIA Priority control (display of overlapping objects) 

Color-Lumimance control (colors and brightness assigned 
to all objects including DMA objects from ANTIC) 
PLAYER-MISSILE objects (4 players and 4 missiles) 

Graphics registers 

Size control 

Horizontal position control 
Collision detection between all objects 
Switches and triggers (miscellaneous I/O functions) 
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CHIP NAME FUNCTION 



Keyboard scan and control 

Serial communications port (bidirectional) 
Pot scan (digitizes position of 8 independent pots) 
Audio generation (4 channels) 
Timers 

IRQ (maskable interrupt) control from peripherals 
Random number generator 

Controller (Joystick) jacks read or write 
Peripheral control and interrupt lines 
IRQ (maskable) interrupt control from peripherals 

Section II describes the hardware in some detail, including the 
various graphics modes. Section III lists the hardware registers one at a 
time, describing what each bit is used for. It is organized by functional 
groups (interrupts, graphics, audio, etc.). Section IV contains a sample 
display program. Section V contains various figures and block diagrams of 
the system. Sections VI and VII list the hardware registers in address 
order and alphabetical order. Section VII includes hex and decimal 
addresses, the OS shadow registers and the page numbers where more infor- 
mation can be found. 



POKEY 
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II. DESCRIPTION OF HARDWARE 



A. ANTIC AND CTIA 



JO 



TV Display : The AN' 
display at the rate of j60 
The PAL (European) sys/tem 
on NTSC vs PAL. Each^ 

up of (22§ color clocks, 
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the television 



:C and CTIA chips gei 

frames per second on the NTSC (US) system, 
is different and Is described in the section 
frame consists of 262 horizontal TV lines and each 

as shown in figure VI-3. The 6502 
microprocessor runs v ~al 1.79 MHz. This rate was chosen so that one 
m achine cycle is equivalent in length to two color clocks. One clock 
is approximately equal in width to two TV lines. 

In any graphics mode, the display is divided up into small squares 
or rectangles called pixels (picture elements). The highest resolution 
graphics mode has a pixel size of 1/2 color clock by 1 TV line. A 
sample display list is given in section IV. 





The current 
(VCOUNT) . 
lines per 



TV line may be determined by reading the vertical counter 
gives the line count divided by 2. There are 262 
so VCOUNT runs from 0 to 130 (0 to 155 on the PAL system). 



This 
frame 

The 0 point occurs near the end of vertical blank (see figure VI. 5). 
Vertical blank (VBLANK) is the time during which the electron beam returns 
back to the top of the screen in preparation for the next frame. The 
Atari 800 does not do interlacing, so each frame is identical unless 
the program which is being executed changes the display. Vertical sync 
(VSYNC) occurs during the fourth through sixth lines of vertical blank 
(VCOUNT = hex 7D through 7F) . This tells the TV set where each frame 
starts. After VSYNC, there are 16 more lines of VBLANK for a total of 22 
lines of VBLANK. The display list jump and wait instruction (to be 
described later) causes the display list graphics to start at the end of 
VBLANK. 
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Operating System (OS) : The ATARI 400/800 comes with a 10K Operating 
System (OS) in ROM. The OS affects some of the hardware registers, so 
it will be mentioned from time to time in this manual. Refer to the OS 
manual for more details. The OS descriptions in this manual apply to the 
version that was being distributed when this manual was written. 

The OS supports most of the hardware graphics modes (BASICS, GRAPHICS, 
PLOT, and DRAWTO commands). The OS always displays 24 background lines after 
the end of vertical blank. This convention is used at Atari to compensate 
for television sets which overscan. Most TV's are designed so that the 
edges of the picture are cut off. This is fine for ordinary broadcasts, 
but with a computer it is essential for all important information to be 
displayed on the screen. It is fairly common for four to eight color 
clocks at the right or left edge of the picture to overscan. A TV set 
that has excessive overscan may have to readjusted to obtain a satisfactory 
display. 



<t>-2.nn ; s-n>. 
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The OS uses 192 TV lines for its display and devotes the remaining 
24 lines to overscan. It uses the standard display width of 160 color 
clocks. The hardware will allow displays of any length, but it is recom- 
mended that the standards be followed. The exception might be a border 
or other information which is merely decorative and not essential to use 
of the program. 



OS Shadowing : Since many of the hardware registers are write-only 
and cannot be read^ the OS has a number of "shadow registers 11 in RAM. 
Every TV frame(during vertical blank) the OS takes the values in some of 
its shadow registers, and writes them out to the corresponding hardware 
register. The OS does attract color shifting on all of the color registers 
if ATRACT (on OS register) is negative. This is to prevent damage to the 
TV screen phosphors which can occur if the brightness is turned up too high 
and the same high- luminance display is left on for a long time. The OS also 
reads the joysticks and other controllers during vertical blank and stores 
t he results i n sha dow registers, so that user programs do not nave to include 
code to unpack thlfdata. There are a few interrupt-related registers which 
the OS changes or reads during interrupt processing. Programs usually access 
the OS shadow registers instead of accessing the hardware directly. However, 
the OS shadowing can be disabled by changing the vertical blank and interrupt 
vectors (see OS manual). 



WSYNC: In addition to a Vertical Blank Interrupt, which allows the 
Microprocessor to synchronize jto the vertical TV display, this system also 
provides a Wait for (Horizontals/Sync (WSYNC ) command that allows the 
microprocessor to synchronize itself to the TV horizontal line rate. This 
sync takes effect when the processor writes to an I/O location called 
WSYNC, whenever it desires horizontal synchronization. Writing to this 
address sets a latch which pulls (to zero) a pin on the microprocessor 
called READY. When READY goes to zero the microprocessor stops and waits. 
The latch is automatically reset (returning READY true) at the beginning 
of the next horizontal blank interval, releasing the microprocessor to 
resume program execution. 

Object DMA (Direct Memory Access) : The primary function of the Antic 
chip is to fetch data from memory (independent of the microprocessor) for 
display on the TV screen. It does this with a technique called "Direct 
Memory Access" or DMA. It requests the use of the memory address and data 
bus by sending a signal called HALT to the microprocessor, causing the 
processor to become "TRI-STATE" (open circuit) all during the next computer 
cycle. The ANTIC chip then takes over the address bus and reads any data 
it wishes from memory. Another name for this type of DMA is "cycle stealing". 
Once initiated, this DMA is completely and automatically controlled by the 
Antic chip without need for futher microprocessor intervention. 

There are two types of DMA: Playfield and PJ^ayer-Missile (see Figure 
II. 2). The playfield DMA control circuit on the Antic chip resembles a 
small dumb microprocessor. By halting the main microprocessor it can 
fetch its own instructions from memory (the display list) addressed by its 
program counter (display list pointer). Each instruction defines the type 

(alpha character or memory map) , and the resolution (size of bits on the 

screen) , and the location of the data in memory which is to be displayed 
on the next group of lines. 
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In order to begin this DMA the main microprocessor must store a 
display list of instructions in memory, store data to be displayed in 
memory, tell the ANTIC where the display list is (initialize the display 
list pointer) and enable the DMA control flags on the ANTIC (DMACTL 
register). 

In addition to the playfield DMA described above, the ANTIC 
chip simultaneously controls another DMA channel. This type of DMA 
addresses PLAYER-MISSILE graphics data stored in memory and passes the 
graphics data on to the CTIA chip graphics registers. This type of DMA 
(if enabled) occurs automatically, interspersed with the playfield DMA 
described previously. This PLAYER-MISSILE DMA has no display list or 
instructions, and is therefore much simpler than the PLAYFIELD DMA. 

In addition to the two types of display DMA, the ANTIC chip also 
generates DMA addresses for the refresh of the dynamic memory RAM used 

in this system. This is also completely automatic and need be consider-^ ^300^0^ /~zrv 
ed by the programmer only if he is concerned with real-time programming h * ()^ 

where an exact count of the computer cycles is important. * (LAffUU- CrwX^ 
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Color-luminance : A color-luminance register is used on the CTIA chip 
for each Player-Missile and Playfield type. Each color-lum register is 
loaded by the microprocessor with a code representing the desired color 
and luminance of its corresponding Player-Missile or Playfield type. As 
the serial data passes through the CTIA chip it is "impressed" with the 
color and luminance values contained in these registers, before being sent 
to the TV display. In areas of the screen where there are no objects the 
background color (COLBK) is displayed. The CTIA also does collision 
detection (to be described later). 



Priority ; When moving objects, such as players and missiles, 
overlap on the TV screen (with each other or with Playfield) a decision 
must be made as to which object shows in front of the other. Objects 
which appear to pass in front of others are said to have Priority over 
them. Priority is assigned to all objects by the CTIA chip before the 
serial data from each object is combined with the other objects and sent 
to the TV screen. 

The priority of objects can be controlled by the microprocessor by 
writing into the control register PRIOR. The functions of the bits in 
this register are given in the table in the PRIOR register description in 
section III. 

Players and Missiles : The players and missiles are small objects 
which can be moved quickly in the horizontal direction by changing their 
position registers. They are called players and missiles because they 
were originally designed to be used in games for objects such as airplanes 
and bullets. However, there are many other possible applications for 
them. The four player-missile color registers, in conjunction with the 
four playfield color registers and the background color register, make 
it possible to display 9 different colors at the same time. 
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Figure II. 2 OBJECT DISPLAY SOURCES 
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There are a total of four players and four missiles. The four 
missiles may be grouped together and used as a 5th player. These 
objects are positioned horizontally by 8 horizontal position registers 
(HPOS (X)). These registers may be reloaded at any time by the proces- 
sor, allowing an object to be replicated many times across a horizontal 
TV line. 

The shape of a player-missile is determined by the data in its 
graphics register (GRAF (X)). Players have independent 8 bit graphics 
registers. The four missiles have 2 bit registers (located within one 
address). These registers may also be reloaded at any time by the 
processor, although they are usually changed during horizontal blank 
time. The data in each graphics register is placed on the display 
whenever the horizontal sync counter equals the corresponding horizon- 
tal position register. The same data will be displayed every line unless 
the graphic registers are reloaded with new data. 

The player-missile graphic registers may be reloaded by the micro- 
processor (GRAF (X))f^or automatically from memory with direct memory 
access (DMA) (see figure II. 3). The programmer must place the object 
graphics in memory, write the player-missile base address (PMBASE) , and 
enable player-missile DMA (DMACTL, GRACTL) «\ The transfer of object 
graphics from memory to display is then fullV automatic. / 

g p v^w^b^ uf^ 

PMBASE specifies the mo/t significant byte (MSB) of the address of 
the player-missile graphics!' The location of the graphics for each 
object is determined by adding an offset to PMBASE *256 (decimal). The 
bytes between the base address and the missile data are not used by 
Antic, so they are available to the programmer. 

Only the five most significant bits of PMBASE are used with 
single-line resolution and the six most significant bits are used 
with two-line resolution. This means that the location of the graphics 
in memory is restricted to certain page boundaries.. Two-line resolu- 
tion means that each byte of data is repeated for two lines. (see 
DMACTL, bit 4). 640 (decimal) bytes (5X128) are required for two-line 
resolution and 1280 bytes (5x256) for one-line resolution. 

Each byte in the player graphics area represents eight pixels which 
are to be displayed on the corresponding line(s) of the TV screen. A 
1 indicates that the player's color-lum is to be displayed in that pixel. 
The graphics may be anything, not just rectangles like the ones in figure 
II. 3. The player graphics may fill the entire height of the screen or 
they may be only a couple of lines high if the rest of the display data is 
all 0's. Each byte in the missile display also represents eight pixels, 
two pixels for each missile. Each pixel may be 1, 2, or 4 color clocks, 
and is determined by the SIZE registers. 



Playfield : Playfield is always generated by DMA. There are four 
playfields, each identified by its own color-lum register and collision 
detection. Playfield is generated by two different DMA techniques: 
memory map and character. Both methods provide lists of instructions in 
memory, independent of the player-missile generation. 
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Player-Missile Base Address (PMBASE) - MSB of address. 
Resolution is controlled by bit 4 of DMACTL. 
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Unlike players and missiles, there are no horizontal position registers 
for playfield. (Each player can only have one byte of display per line.) 
Playfield, on the other" hand, may require up to 48 bytes per line because 
it can fill the entire width of the screen. 

There are three different playfield widths: narrow (128 color 
clocks), standard (160 color clocks), and wide (192 color clocks). 
The width is selected by storing into DMACTL. The advantage of a narrower 
width is that less RAM is required and fewer machine cycles are stolen for 
DMA. The OS graphics modes use the standard screen width. 



Display List ; The display list is a sequence of display instructions 
stored in memory. These instructions are either one (1) byte or three (3) 
bytes long. The display list can be considered a display program, and the 
Display List Counter that fetches these instructions can be thought of as 
a display program counter. (10 bit counter plus 6 bit base register.) 

The display list counter can be initialized by writing to DLISTH and 
DL1STL. (or OS shadow registers SDLSTH and SDLSTL). Once initialized, 
this counter value is used to address the display list, fetch the instruc- 
tion, display one (1) to sixteen (16) lines of data on the TV screen, 
increment the Display List Counter, fetch the next display instruction, 
and so on automatically without microprocessor control (see DL1STL and 

ffDLISTH). DLISTL and DLISTH should be altered only during vertical blank 

For when DMA is disabled (see DMACTL). 

Each instruction defines the type (alpha character or memory map) and 
the resolution (size of bits on screen) and the location of data in memory 
to be displayed for a group (1 to 16) of lines. Each group of lines is 

called a display block. 

THE DISPLAY LIST CANNOT CROSS A IK BYTE MEMORY BOUNDARY UNLESS 

A JUMP INSTRUCTION IS USED. 



DLISTH (MSB) 



DLISTL (LSB) 




Fixed (6 bits) 



Counter (10 bits) 
DISPLAY LIST COUNTER 
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Display Instruction Format : Each instruction consists of either an 
opcode only, or of an opcode followed by two (2) bytes of operand. 



lOpcodel Single Byte Display Instruction 



lOpcodel 

I Operand I ) Triple Byte Display Instruction 

foperand"! 

The opcode is always fetched first and placed in the Instruction 
Register. This opcode defines the type of instruction (1 or 3 bytes) 
and will cause two more bytes to be fetched if needed. If fetched, 
these next two (2) bytes will be placed in the Memory Scan Counter ! 
or in the Display List Counter (if the instruction is a Jump). 



4- # 




Display Instruction Register (IR) ; This register is loaded with the 
opcode of the current display list instruction. It cannot be accessed 
directly by the programmer. There are three basic types of display list 
instructions: blank, jump, and display. 



Blank 
(1-byte) 



r> 0 O ° 

|P7lD6lD5lD4l 01 01 0| Q| 



This instruction is used to create 1 to 8 blank lines on the 
Jx> t^^isplay (blackground color). 

color €ir 

07 I m display list instruction interrupt 

D6 - D4 0-7 = 1-8 blank lines 
D3 - DO 0 - blank 



Jump 

(3-bytes) 



Display 

(1 or 3 bytes) 



p Oft *wky\*x0 
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Id7ID6I XI Xl 01 01 01 1| 
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This instruction is used to reload the Display List Counter. 
The next two bytes specify the address to be loaded (LSB first) 



D7 
D6 

D5-D4 
D3-D0 

I 



1 
0 
1 

X 

1 



display list instruction interrupt 

jump (creates one blank line on display) 

jump and wait until end of next vertical blank 

don't * 0 

jump 



care 



I 




|D7iD6lD5lD4lD3lD2lDlTD0l 
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This instruction specifies the type of display for the next 
display block 



D7 
D6 



D5 
D4 

D3-D0 



1 
0 
1 

1 
1 

2-F 



display list instruction interrupt 
1 byte instruction 

3 byte instruction (reload Memory Scan Counter 

using address in next two bytes, LSB first). 

vertical scroll enable 

horizontal scroll enable 

display mode (memory or character map - 

see following pages). 



II. 8 



3 

o a) 



00 








a 




CO 


0 


•H 






O 


rH 


c 




•H 


rH 


•H 


a 




O 


rH 


CO 


a 


V-i 


rH 


o 




O 


O 


co 




CO 


M 








CJ 




CO 


rH 


CO 




c 


CO 




O 


*H 


4-» 


rH 


B 




c 


cO 






o 


a 


e 


CO 


N 


•H 




rH 


•H 


4J 






H 




CO 


CO 


o 


0) 


O 


•H 




> 




P 



x 



X 
X 



x 

X 



X 
X 



x 

X 



X 
X 



X 
X 



X 
X 



X 
X 



X 
X 



X 
X 



X 
X 























0 
















cO 














0 


rH CD 














O 


PQ 4-) 














•H 
















4-» 














CO 


O 














CD 


0 


U CO 












0 


M 


CD 












•H 




> O 










Ml 

nd CO 




ns 


CO 

U rH 




CD 








•H 


O CO 






CO 




O 0 


CO CO 








o 


a 




X o 


CD CD 3 CD 


CD 








o 




•H 


a a m 0 


4-J 


4-» 






•H 






•H *H X! "H 






u 


4J 




cO O 


rH rH 4-> rH 




wa 




te 


o 

0 




ru 


CN CO 00 


CO 






u 


U 










«« 




CO 


u 




M CO 


M ^ M ^ 








u 


CO 




o a 


c c c c 


a 






CO 






B M 


CO cO CO cO 


e 


e 






M 




CD 


rH rH rH rH 








u 








CD CD CQ CQ 




















CM 


CO 


<r 


m 




NCOC^<lFQUDW 






fa 


fa 


fa 


fa 


fa 


r*<fafafafafafafa 






Csl 


CO 


<* 


m 


v£5 


r^ooaN<!pQOOW 






W 


W 


W 


W 


W 


wwwwwwww 



X 
X 



X 
X 



X 

x^ 
xm 

X 



QQQQQQpPQPOPQn 



x 

x 



Nfn^mvDNCOO\<JpQUP WW 
fCpQpQpQpQPQPPPQPOPPPQPPPPPQ 



x 

X 



x 
x 



X 
X 



X 
X 



X 
X 



XI 
X 



X 
X 



X 
X 



X 
X 



X 
X 



C^C^CT>CTvCT»0>C7>Cy»cy\CJ\CyNO>CTk cjn 



X 
X 



x 

X 



x 

X 



x 

X 



x 

X 



oo OHHMn^mvDNooo><!«upW^ 
00 C?\ fa 00 ucocococococooooococooocooooo| 



CNjn^in^D^coc^^cDUpWful 

CNjco<rinvX5r^C)OON<JpQOOWfa 
mLnmmmmmmmmminm ml 

Nco^invDNooa\<ipQupWfe 

Nco<rmvDNooo><jpqupWPn| 
cocococococococococococoroco 

Nm^mvDNcoc^<jJpQOPWN 

CsICnICnICsICvJCnICnICnICsICsICnICnJCSICsI 

Nm<rLn^NoooN<;cDUPW^| 



o r-i r^o<rooooooooooooo 



rJ 


t— 


O 


o 






o 


o 


CO 


CO 




> 



55 

o 

CO 

p| 
►J 



H 
fa 

Pi 
w 

H 

5Z 



H 

CO 



x-n O /"N VD ^ ^ * <"N «-N /— > 

00«-HCX5^-lCO'-HC30<r>d-CN^CN|r-jF-H| 

CNiCNi<r<rinin<rcsi^-csjcNi<f^-CNi 
00000000000000 

| ^-<r<T<fCslCSJ^-CX>00vOv£>v£)v£>CN 
f— 1 CM CO C30 wwwwwwwwWr-H^H^Hi-H CO| 

p_ pq prj P-> 
^= = r ^>pcr = r = = <=s = = = r- 
pq *-d cj> X 



0 

CD 

^ CD 
CO U 
CD O 
CU CO 

r^ 

4J 

rH *H 

CD ^ 
•H 

U 

cO cO 

rH T3 

co 

+ 4J 

CO 

rH 0 

rH 2 CO 
CD O rH 
O U rH 
00 CD 

U M o 
CD CJ 
PL CO rH 
PQ CO 
CO w 4-> 

CD C 

CS CO O 

•H H N 

rH O «H 

rH M 

> O O 

H U S 

M-4 IH U-4 
O O O 

VJ u u 

CD CD CD 
X> r& & 

& B B 
& & 



CO 

w 

p 
o 

o 

O 
M 

H 
O 
P 

H 
co 

5S 
M 

< 

rJ 

Ph 
CO 
M 

P 



On 



CO 



CD 
U 

0 
00 
•H 
fa 



/ 



Bit 7 of a display list instruction can be set to create a disnlav 
list interrupt if bit 7 of NMIEN is set. The display list intirrup? code 
can change the colors or graphics during the middle of the TV display? 
m^ yPe T? interru Pt is determined by checking NMIST. NMIRES clears 
NMIST. The current OS will vector through VDSLST (Hex 200 and 201) to 

^details P ^ 8 " the ° S * anual for P«£~ 



tn ^ \ ! t l8play type ° f dis P la y l^t instructions are used 

to enable vertical and horizontal scrolling. The amount of scrolling 
depends on the values in the VSCROL and HSCROL registers (to be descr 



ribed 



X 



Memory Scan Counter; This counter is not directly accessible by the 
programmer. It is loaded with the value in the last 2 bytes of a 3 byte 
(non-Jump) instruction. y 

^^M l8 ^°T er P° ints to the location (address) in memory of data to be 
directly displayed (memory map display) or to the location of character 
name strings to be indirectly displayed (character display). 

.... d<5pl*yf«f $q fK, tyfrjC , mtre 

A single byte instruction does not reload this counter. T^iis implies^ 
a continuation in memory of data to be displayed from that displayed by 
the previous instruction. Since this counter really consists of A bits of 

Ikw! 1 ™ K° f ! Ct ? al COUnter » a continuous m emory block cannot cross 

4K byte memory boundaries, unless the counter is repositioned with a 3 

byte Load Memory Scan Counter instruction. 



if 



MSB third byte of 3-byte 
byte instruction 



LSB Second byte of 3- 
byte instruction 




I I I \ I j \~ 
716151 41312(1 in 




i 



Fixed (4 bits) 



\ 



I7I6I5I4I3I2I1I0 



Counter (12 bits) 



Memory Map Display Instructions; Data in memory (addressed by the 
Memory Scan Counter) is displayed directly when executing a memory (bit) 
map display instruction. As data is being displayed it is also stored in 
a shift register so that it can be redisplayed for as many TV lines as 
required by the instruction. 
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Memory Scan Counter 
Addresses each byte 



One line worth of memory is 
loaded into the shift register 



Memory 



Shift 




Register r \ * 






i i i i i i i i i i i 




1 1 1 1 1 1 1 ■Til 






Shift register data is displayed for four TV scan lines in this example. 



In Instruction Register (IR) display modes 8 through F, one or two 
bits of memory are used to specify what is to be displayed on each pixel 
of the screen. Pixel sizes range from 1/2 clock by 1 TV line to 4 clocks 
by 8 TV lines. The OS and BASIC support most of these graphics modes 
(BASIC GRAPHICS command). Two modes, C and E, are not supported by the 
OS. These modes have rectangular pixels, which are approximately twice as 
wide as they are high. 



In IR mode F, only one color (C0LPF2) can be displayed. Two different 
luminances are available. If a bit is a zero, then the luminance of the 
corresponding pixel comes from C0LPF2. If the bit is a one, them the 
luminance is determined by the contents of C0LPF1 (abbreviated to PF1). 

In IR modes 9,B, and C, two different colors can be displayed. A 
zero indicates background color and a one indicates PFO color. The 
difference between the various modes is in the size of the pixels. 

In IR modes 8,A,D, and E, two bits are used to specify the color 
of each pixel. This allows four different colors to be displayed. 
However, only four pixels can be packed into each byte, instead of eight 
as in the previous modes. The bit assignments are shown below. 

SHIFT REGISTER I 7 6 I 5 4 j 3 2 I 1 0 I 7 6 1 5 4 I 3 2 I 1 0 I 



2 bits form 
one pixel 
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Memory Map Display Modes 



| OS 
| and 
| BASIC 
| Modes 


1 

llnst. 
I Reg. 

HEX 


IColors 
1 per 
| Mode 


I Pixels 
1 per 
I Std. 
Line 


I Bytes 
1 per 
IStd. 
Line 


I Scan 
| Lines 
1 per 
Pixel 


I Color 
| Clocks 
1 per 
Pixel 


|Bits 
1 per 
Pixel 


I Bit 
lvalues 
1 in 
Pixel 


1 
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1 Reg. 
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1 3 
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1 4 
1 


I 40 


1 10 


1 8 


1 4 
1 


1 2 


00 
1 01 
1 10 
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I 80 


1 10 


1 4 


1 2 
1 
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| BAR 
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1 A 
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1 


I 80 


I 20 
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1 2 
1 


1 2 


00 
1 01 

1 io 

11 


BAR 

I PF0 
1 PF1 
PF2 


1 6 j 


1 B | 

1 1 


2 


I 160 


1 20 


! 2 

1 ! 


1 1 

! 


! 1 


f 0 

1 1 


BAR 
PF0 


- | 
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c 1 
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2 I 

1 


160 | 


20 | 


1 1 

1. 1 


l 1 
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1 | 
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1 1 


BAR 
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7 I 
1 
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D | 
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4 I 


160 | 
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2 I 
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1 1 
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2 I 


00 

oi 1 
io 1 
11 


BAR 
PF0 
PF1 
PF2 


I 

- 1 
1 


E I 
1 


4 I 


160 | 


40 | 


1 1 
1 


l | 


2 I 


00 

oi 1 

10 • | 

11 


BAR 
PF0 ! 
PF1 | 
PF2 


8 I 
1 
1 


1 
1 


iH | 


320 | 


40 | 


1 1 
1 
1 


h | 


1 | 


0 1 

1 1 

1 


PF2 | 
PF1 | 
(LUM) i 



Character Display Instructions : The first step in using the character 
map mode is to create a character set in memory (or the built-in OS 
character set at hex E000 may be used) . The character set contains eight 
bytes of data for the graphics for each character. The meaning of the 
data depends on the mode. The character set can contain 64 or 128 characters, 
also depending on the mode. The MSB (Most Significant Byte) of the 
address of the character set is stored in CHBASE (or the OS Shadow CHBAS) . 
Only the most significant six or seven bits of CHBAS are used (see CHBASE 
description in section III). The other one or two bits and the LSB of the 
address are assumed to be zero, so the character set must start at an 
acceptable page boundary. 

The next step is to set up the display list for the desired mode. 
Then the actual display is set up. This consists of a string of character 
names or codes. Each name takes one byte. The last 6 or 7 bits of the 
name selects a character. For a 64 character set, the name would range 
from 0 through 63 (decimal). For a 128 character set, the range would be 
0 through 127 (decimal). The upper one or two bits of the name byte are 
used to specify the color or other special information, depending on the 
mode. 

Character names (codes) are fetched by the memory scan counter, and 
are placed in a shift register. On any given line of display the shift 
register rotates, changing only the name portion of the character address 
as shown below. £u>y^~ J 



After a full /lin^) of character data has been displayed the 3-ine^ 
counter will increment. The next line again addresses all characters by 
name for that line number. 

In 20 character per line modes the seven most significant bits of 
CHBASE are used. This requires that the character set to start upon a 512 
byte memory boundary. The set must contain 64 charcters, 8 bytes each, 
giving a total of 512 bytes for the set. 

The 40 character per line modes use the six most significant bits 
of CHBASE, forcing the character set to start on a IK byte memory boundary. 
The set must have 128 characters of 8 bytes each. This gives a total of 
1024 bytes for the set. 




| Hex 
j Code 

1 


Graphics 
Mode 


Chars. 

Per j 
Line 


Number 

of I 
Colors 


Bytes | 
per | 
Char. 


Number 

of Char. j 

in set 


Bytes | 
in | 
Char Set 


1 

1 2 | 


0 


40 


2 


8 


128 


1024 


1 

3 




40 


2 


8 


128 


1024 


4 


- 


40 


4 


8 


128 


1024 


1 

15 1-1 


40 


1 

4 


Q 


128 


1 1024 I 


1 


1 

1 


1 20 


5 


8 


64 


1 

512 


+— *— 

1 7 


1 2 


1 20 


1 5 


! 8 


64 


512 | 
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Character Display 
(20 Character per line mode example) 

Codes (names) 
Stored in 
Shift Reg 



Internal 
codes for 
characters 
in memory 




Shift 


1 


1 1 1 1 1 




Register 


1 


1 1 1 1 1 





Color 
Register 
Select 



Address portion of 
Character name 



CHBASE 




Character Set 
in Memory 



Addresses data in 
character set 

and displays on the 
TV 



Color assigned 
by color register 
selected 




TV 

Scan 

Lines 
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There are six charcter map modes, IR modes 2 through 7. Modes 2,6 
and 7 are supported by the OS and BASIC (GRAPHICS 0,1 and 2). 

In IR modes 6 and 7, the upper two bits of each character name select 
one of four playfield colors. For each data bit that contains a one, the 
selected playfield color is displayed. For each zero data bit, the 
background color is displayed. The four character colors plus the background 
color gives a total of five different colors, the mode 6 characters are 
eight lines high and the mode 7 characters are sixteen lines high (each 
data byte is displayed for two lines). 





In IR modes 4 and 5, each character is only four pixels wide instead 
of eight (as in the other modes) . Two bits per pixel of data are used to 
select one of three playfie ld colors, or background. Seven name bits are 
used to select the character. If the most significant name bit is a zeroj 
then data of (binary) selects PF-?. If the name bit 7 is one. then data 
bits of 



th 



selects PFl. If the 
^select PFl.^r This makes it possible to display two characters 
different colors, using the same data but different name bytes. ^Jgge 



In IR modes 2 and 3, each pixel is half of a color clock in width. CoOr^erJ 
is makes it possible to have forty (4ight-pixel-wide)characters in a 
standard width line. These modes are similar to memory mode F in that two 
luminances can be displayed, but only one color is available at a time. 
In IR mode 3, each character is 10 lines high. This makes it possible to 
define lower case characters with descenders. The last fourth of the 
character set (name bits 5 and 6 equal to one) is lowered. The hardware 
takes the first two data bytes and moves them to the bottom of the character, 
displaying two blank lines at the top of the character (see next page). 

In IR modes 2 and 3, bit 7 of the character name is used for inverse 
video or blanking. This is controlled by CHACTL (Character Control). If 
bit 2 of CHACTL is a one then all of the characters will be displayed 
upside down, regardless of mode. If CHACTL bit 1 is set, then each 
character which has bit 7 of its name set will be displayed in inverse 
video (the luminances will be reversed). If CHACTL bit 0 is set, then 
each character which has bit 7 set will be blanked (only background wil be 
displayed). Characters can be blinked on and off by setting name bit 7 to 
1 and toggling CHACTL bit 0. Inverse video and blank apply only to IR 
modes 2 and 3. If both inverse video and blank are set then the character 
will appear as an inverse video blank character (solid square). 



Hardware Collision Detection : 60 bits of collision register are 
provided to detect and store overlap (hits) between players, missiles and 
playfield. These collisions can be read by the microprocessor from 
addresses D000 through DOOF. There are no bits for missile to missile 
collisions. 

16 bits for Missile to Playfield 
16 bits for Player to Playfield 
16 bits for Missile to Player 

12 bits for Player to Player (PO to PO always reads as zero, etc.) 

NOTE: The 1/2 clock memory map mode (IR code 1111) and the 1/2 clock Character 
mode (IR codes 0011 and 0010) are both playfield type 2 collisions and will 
be stored in bit 2 of the playfield collision registers. 

le.vi^x my \% tA** ****** , pu^faM>fc 
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IR Mode 3-Upper and Lower Case 



Upper Case 



Data 




Actual 
Display 




Lower Case 
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IMM - IMMEDIATE ADDRESSING - THE OPERAND IS CONTAINED IN THE SECOND BYTE OF THE 
INSTRUCTION 

ABS ABSOLUTE ADDRESSING - THE SECOND BYTE OF THE INSTRUCTION CONTAINS THE 8 

LOW ORDER BITS OF THE EFFECTIVE ADDRESS. THE THIRD BYTE CONTAINS THE 8 

HIGH ORDER BITS OF THE EFFECTIVE ADDRESS. 
Z, PAGE ZERO PAGE ADDRESSING - SECOND BYTE CONTAINS THE 8 LOW ORDER BITS OF 

THE EFFECTIVE ADDRESS THE 8 HIGH ORDER BITS ARE ZERO. 
A, - ACCUMULATOR - ONE BYTE INSTRUCTION OPERATING ON THE ACCUMULATOR 
Z. PAGE, X - Z PAGE. Y ZERO PAGE INDEXED - THE SECOND BYTE OF THE INSTRUCTION IS 

ADDED TO THE INDEX (CARRY IS DROPPED) TO FORM THE LOW ORDER BYTE OF THE 

EA. THE HIGH ORDER BYTE OF THE EA IS ZEROS. 



ABS, X ABS, Y ABSOLUTE INDEXED - THE EFFECTIVE ADDRESS IS FORMED BY ADDING THE 
INDEX TO THE SECOND AND THIRD BYTE OF THE INSTRUCTION. 

(IND, X) - INDEXED INDIRECT - THE SECOND BYTE OF THE INSTRUCTION IS ADDED TO THE X 
INDEX, DISCARDING THE CARRY. THE RESULTS POINTS TO A LOCATION ON PAGE 
ZERO WHICH CONTAINS THE 8 LOW ORDER BITS OF THE EA. THE NEXT BYTE CON 
TAINS THE 8 HIGH ORDER BITS. 

(IND), Y ■ INDIRECT INDEXED - THE SECOND BYTE OF THE INSTRUCTION POINTS TO A LOCA 
TION IN PAGE ZERO THE CONTENTS OF THIS MEMORY LOCATION IS ADDED TO THE Y 
INDEX, THE RESULT BEING THE LOW ORDER EIGHT BITS OF THE EA. THE CARRY 
FROM THIS OPERATION IS ADDED TO THE CONTENTS OF THE NEXT PAGE ZERO LOCA 
TION, THE RESULTS BEING THE 8 HIGH ORDER BITS OF THE EA. 
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Vertical and Horizontal Fine Scrolling ; Playfield objects are difficult 
to move smoothly. Memory map playfield can be moved by rewriting sections 
of memory. However, this is extremely time-consuming if large sections 
of the screen must be moved smoothly. Character playfield objects can be 
moved easily in a jerky fashion by changing the memory scan counter. 
However, this results in a large position jump from one character position 
to another, not a smooth motion. For this reason hardware registers 
(VSCROL and HSCROL) and counters are provided to allow smooth horizontal 
or vertical motion, up to one character width horizontally and up to one 
character height vertically. After this much smooth motion has been 
done by increasing the value in these registers, memory is rewritten or 
the memory scan counter is modified and smooth motion is resumed for 
another character distance. 



Vertical Scrolling : A zone of playfield on the screen can be scrolled 
upward by using VSCROL and bit 5 of the display list instruction. The 
^^P}^^^^}^ at the upper and lower boundaries of the zone must have a 
vafriablevertlcal size. In particular, the first display block within that 
zone must be shortened from the top, and the last display block must be 
shortened from the bottom (i.e. not all of the top and bottom blocks will 
be displayed) • 

The vertical dimension of each display block is controlled by a 4 bit 
counter within the ANTIC, called the 'Delta Counter' (DCTR) . Without 
vertical scrolling, it starts at 0 on the first line, and counts up to a 
standard value, determined by the current display instruction. (Ex: 
for upper and lower case text display, the end value is 9. For 5 color 
character displays, it is 7 or 15.) 

If bit 5 of the instruction remains unchanged between consecutive 
display blocks, then the second block is displayed in the normal fashion. 
If bit 5 of the instruction goes from 1 to 0 between two consecutive 
display blocks, the second block will start with Delta = 0, as usual, but 
will count up until delta=VSCROL , instead of the standard value. This 
shortens that display block from the bottom. 

To define a vertically scrolled zone, the most direct method is to 
set bit 5 to 1 in the first display instruction for that zone, and in all 
consecutive blocks but the last one. If the VSCROL register is not 
rewrittren on the fly, this results in a total scrolled zone that has a 
constant number of lines (provided that the VSCROL value does not exceed 
the standard individual block size). If N is the standard block size, the 
top block will be N-VSCROL lines (N > VSCROL ), and the last block will be 
VSCROL + 1 lines: (N-VSCROL) + (VSCROL + 1) = N + 1. Shown on the 
following page is an example of a scrolled zone, top block, for 8 VSCROL 
values for N = 8. 

Horizontal scrolling is described under HSCROL in section III. 
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Simple Display List Example ; BASIC starts out in OS graphics mode 0 
which displays 40 characters across by 24 rows. This is IR mode 2 with a 
standard screen width. The OS sets up the display list near the top of 
RAM with room for the character names at the top of RAM. On a 32 K-byte 
machine, the display list would start at hex 7C20. The next three bytes 
are hex 70's to create 24 blank lines. The next byte is a hex 42. The 
4 tells the hardware to reload the memory scan counter with the following 
address (7C40). This is the address of the data to be displayed. The 2 
tells the hardware to display one line of IR mode 2 characters. The 
next 23 bytes specify 23 more lines of mode 2 characters. Hex 41 is the 
code for jumping and waiting until the end of the next vertical blank. 
The address to jump to is 7C20, the start of the display list. The next 
960 bytes are the list of characters to be displayed, 40 bytes per line. 
The OS must set up the display list pointer (DLISTH and DLISTL) to the 
starting address of the display list (7C20). It also sets CHBASE to the 
MSB of the address of the character set (E0) . 

This is a simple example because only one mode is used and the memory 
scan counter is only loaded at one point. It is possible to have different 
modes on different lines, change character sets and colors, etc., as shown 
in the example in Section IV. 



ft 
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OS Mode 0 Display List (40 chars x 24 lines) 



Address (hex) 



7C20 



Data (hex) 





24 blank lines 

reload memory scan counter with 
IR mode 2 

A 




7C40 



30H7 

3^00 




23 more IR mode 2 instructions 

Jump back to 7C20 and 
20 ) wait for end of vertical blank. 

960 bytes of display data 
(character names) 

Cycle Counting : As explained previously, the ATARI 800 6502 micropro- 
cessor runs at a rate of 114 machine cycles per TV line (1.79 MHZ). There 
are 262 lines per TV frame and 60 frames per second on the NTSC (US) system. 
(The PAL (Europeon) system is different. See the section on NTSC vs. PAL.) 

Each machine cycle is equivalent in length to 2 color clocks. There 
are 228 color clocks on a TV line. The highest resolution graphics modes 
have a pixel size of 1/2 color clock by 1 TV line. Horizontal blank takes 
40 machine cycles. This is when the beam returns to the left edge of the 
screen in preparation for displaying the next TV line. A wait for Sync 
(WSYNC) instruction stops the 6502." The processor is restarted exactly 7 
machine cycles before the beginning of the next TV line. The program can 
thus change graphics or colors during horizontal blank in preparation for 




the next line. 



p<*2* IT pi 



The ANTIC chip steals cycles from the 6502 in order to do memory 
refresh and fetch graphics data when needed. The general rule to remember 
is that each byte fetched from memory requires one machine cycle. If a 
display list memory map instruction extends over several lines then the data 
is only fetched on the first line. Memory refresh takes 9 cycles out of 
every line, unless pre-empted by a high-resolution graphics mode. Memory 
refresh continues during vertical blank. 

Missile DMA takes one cycle per line in the one-line resolution mode 
and one cycle every other line in the two line resolution mode. Missile 
DMA can be enabled without doing player DMA. However, if player DMA is 
enabled then missile DMA will also be done (see DMACTL, GRACTL bits). 
Player DMA requires 4 cycles every one or two lines, depending on the 
resolution used. 
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Each fetch of a display list byte takes one cycle, so three cycles 
are required for a three byte instruction. 

Player/missile and display list instruction fetch DMA take place 
during horizontal blank, if they are required for the next line. 

In memory map modes, the graphics data is fetched as needed throughout 
the first A line of the display list instruction/, then saved by ANTIC for 
use in succeeding lines. In character modes, the character codes are 
fetched during the first line e of each row of characters, along with the 
graphics data needed for that line. On the next lines, only the graphics 
data is fetched, since ANTIC remembers the character codes. 

In the 40 x 24 character mode, with a standard screen width, most of 
the cycles during the top line of each row of characters are requried to 
fetch the character codes and data, so there is only time for one memory 
refresh cycle instead of the usual nine. Less DMA is required with a narrow 
screen width so two memory refresh cycles would occur in ifiie case. 

The memory refresh is done fast enough to make up for the lost cycles 
in the high resolution modes. Once memory refresh starts on a line, it 
occurs every four cycles unless pre-empted by DMA. 

All interrupts reach the 6502 near the end of horizontal blank. 
With standard or narrow screen widths, refresh DMA starts after the end of 
horizontal blank. 

The time at which ANTIC does cycle stealing is deterministic, but 
depends on the graphics mode, screen width and whether or not horizontal 
scrolling is enabled. Horizontal scrolling requires extra graphics d ata; 
see HSCROL. TH , 

ANTIC does horizontal scrolling of an even number of color clocks by 
delaying the time at which it DMA's the data. To do an odd number of color 
clocks (which involves half of a machine cycle) , ANTIC has a one color clock 
internal delay. 

Theoretically, it is possible to write a program which changes graphics 
or colors "on the fly", i.e. during the middle of a TV line. However, 
with all the DMA going on, the cycle counting gets to be quite complicated, 
and is beyond the scope of this manual. 

There are a number of delays associated with the display of graphics. 
These occur in the ANTIC and the CTIA. The ANTIC sends data to the CITA 
which adds in the color information. Thus the timing for changing colors on 
the fly is different from that for changing graphics on the fly. 

bey 0*4. ?&*f* &l 
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Horizontal Blank DMA Timing 



When DMA is enabled, cycles are stolen at the times shown below. 

End of 



ft-l 



evious^ 
Line 



Horizontal Blank 



5 I 4 



I 1 I 1 I 

A A 



20 machine cycles (40 color clocks) 



WSYNC 



4 
A 



I 



A ' 



| ) I ( 
8 



A 



1-9 refresh cycles, 
char, and graphics 
data DMA (depends on 
graphic mode) 



^Interrupt 
Address DMA 



— 



.Player 
Display list 
Missile DMA 



(3-byte display list 
instruction) 

instruction fetch DMA 



Cycle Counting Example : This example uses the 40 character by 24 line 
display list given on page 11.24. This display list is 32 bytes long so 
display list DMA takes [32] machine cycles. It takes 960 cycles to DMA the 
characters and (^*96Q to DMA the character data. The refresh DMA takes 9 
cycles for each of 262 lines, except for the 24 lines where the characters 
are read, where only 1 refresh cycle occurs. \ x£^ ts 



DMA description 

display list 

characters 

character data 

refresh 

total 



Machine cycles 

= 960 
=7680 
=2166 



40x24 
960x8 
262x9-24x8 




10838 



Thus the total DMA per frame is 10838 machine cycles. One frame 
is 262 lines with 114 machine cycles per line for a total of 29868 machine 
cycles per frame. Thus 36% of each frame is required for DMA in OS graphics 
mode 0. 



NTSC vs. PAL Systems ; There are two versions of the ATARI 800: the NTSC 

(United States T.V. standard) and PAL (one of the European T.V. standards). 

The PAL system has been designed so that most programs will run without 

being modified. However, some differences may be noticeable. There is a 

hardware register (PAL) which a program can read to determine which type of 
system it is running on and adjust accordingly. 
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The PAL T.V. has a slower frame rate (50 Hz. instead of 60 Hz.) so 
games will be slower unless an adjustment is made. PAL has more T.V. 
lines per frame (312 instead of 262). The Atari 800 hardware compensates 
for this by adding extra lines at the beginning of vertical blank. Display 
lists do not have to be altered. However, their actual vertical height will 
be shorter. PAL ATARI 800 colors are similar to NTSC because of a hardware 
modification. 



B. POKEY BASIC: Vovte, f HrtW , ; ^f(^j M*"* 

Audio: There are 4 semi- independent audio channels, each with its own 
frequency, noise, and volume control. Each has an 8 bit "divide by N 

eque ncy divider, controlled by an 8 bit register (AUDFX) . (See audio-serial 
port block diagram. )TOEach channel also has an 8 bit control register (AUDCX) 
which selects the nois\ (poly counter) content, and the volume. 

Frequency Dividers : All 4 frequency dividers can be clocked simultane- 
ously from 64 KHZ or 15 KHZ. (AUDCTL bit 0). Frequency dividers 1 and 3 
can alternately be clocked from 1.79 MHZ (AUDCTL bits 6 and 5). Dividers 2 
and 4 can alternately be clocked with the output of dividers 1 and 3 (AUDCTL 
bits 4 and 3). This allows the following options: 4 channels of 8 bits 
resolution, 2 channels of 16 bit resolution, or 1 channel of 16 bit and 2 
channels of 8 bit. WVWaA- t ut^ty Omdtn uvtd T 

Poly Noise Counters : There are 3 polynomial counters (17 bit, 5 bit 
and 4 bit) used to generate random noised The 17 bit poly counter can be 
reduced to 9 bits (AUDCTL bit 7). These counters are all clocked by 1.79 
MHZ. Their outputs, however, can be sampled independently by the four 
audio channels at a rate determined by each channel's frequency divider. 
Thus each channel appears to contain separate poly counters (3 types) 
clocked at its own frequency. This poly counter noise sampling is controlled 
by bits 5,6 and 7 of each AUDCX register. Because the poly counters are 
sampled by the "divide by N" frequency divider, the output obviously cannot 
change faster than the sampling rate. In these modes (poly noise outputted) 
the dividers are therefore acting as "low pass" filter clocks, allowing only 
the low frequency noise to pass. 

The output of the noise control circuit described above consists of 
pure tones (square wave type), or polynomial counter noise at a maximum 
frequency set by the "divide by N" counter (low pass clock). This output 
can be routed through a high pass filter if desired (AUDCTL bits 1 and 
2). 
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Audio Noise Filters: 



VOL 



A 



(Low pass noise cut off set 
by Divide by N counter. 



Low Frequency 
Noise 



Frequency 



Any channel noise output (without high pass filter) 




/Channel 1 
I - by N 



Channel 1 output (with high pass filter) 



VOL 
A 



Channel 4 
(or 3 & 4) 
- by N 





Channel 2 
((or 1 & 2) 
I - by N 



Channel 2 output (with high pass filter) 



Frequency 



Frequency 



Clock 




cU3 

OYck 4 
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High Pass Filters : The high pass filter consists of a "D" flip flop 
and an exclusive-OR Gate. The noise control circuit output is sampled by 
this flip flop at a rate set by the "High Pass" clock. The input and output 
of the Flip Flop pass through the exclusive-OR Gate. If the flip flop input 
is changing much faster than the clock rate, the signal will pass easily 
through the exclusive-OR Gate. However, if it is lower than the clock rate, 
the flip flop output will tend to follow the input and the two exclusive-OR 
Gate inputs will mostly be identical (11 or 00) giving very little output. 
This gives the effect of a crude high pass filter, passing noise whose 
minimum frequency is set by the high pass clock rate. Only channels 
1 and 2 have such a high pass filter. The high pass clock for channel 1 
comes from the channel 3 divider. The high pass clock for channel 2 comes 
from the channel 4 divider. This filter is included only if bit 1 or 2 of 
AUDCTL is true. 



Volume Control : A volume control circuit is placed at the output of 
each channel. This is a crude 4 bit digital to analog converter that 
allows selection of one of 16 possible output current levels for a logic 
true audio input. A logic zero audio input to this volume circuit always 
gives an open circuit (zero current) output. The volume selection is 
controlled by bits 0 thru 3 of AUDCX. "Volume Control only" mode can be 
invoked by forcing this circuit's audio input true with bit 4 of AUDCX. In 
this mode the dividers, noise counters, and filter circuits are all discon- 
nected from the channel output. Only the volume control bits (0 to 8 of 
AUDCX) determine the channel output current. 

The audio output of any channel can be completely turned off by writing 
zero to the volume control bits of AUDCX. All ones gives maximum volume. 



C. SERIAL PORT 



The serial port consists of a serial data output (transmission) 
line, a serial data input (receiver) line, a serial output clock line, a 
bi-directional serial data clock line, and other miscellaneous control lines 
described in the Operating System Manual. Data is transmitted and received 
as 8 bits of serial data preceded by a logic zero start bit, and succeeded 
by a logic true stop bit. Input and output clocks are equal to the baud 
(bit) rate, not 16 times baud rate. Transmitted data changes when the 
output clock goes true. Received data is sampled when the input clock goes 
to zero. 



Serial Output : The transmission sequence begins when the processor 
writes 8 bits of parallel data into the serial output register (SEROUT) (see 
audio and serial port block diagram) . When any previous data byte trans- 
mission is finished the hardware will automatically transfer new data from 
(SEROUT) to the output shift register, interrupt the processor to indicate 
an empty (SEROUT) register (ready to be reloaded with the next byte of 
data), and automatically serially transmit the shift register contents with 
start-stop bits attached. If the processor responds to the interrupt, and 
reloads SEROUT before the shift register is completely transmitted, the 
serial transmission will be smooth and continuous. 
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Output data is normally transmitted as logic levels (+4V=true OV=False) 
Data can also be transmitted as two tone information. This mode is selected 
by bit 3 of SKCTL. In this mode audio channel 1 is transmitted in place of 
logic true, and audio channel 2 in place of logic zero. Channel 2 must be 
the lower tone of the tone pair. 

The processor can force the data output line to zero (or to audio 
channel 2, if in two tone mode) by setting bit 7 of SKCTL. This is required 
to force a break (10 zeros) code transmission. 

Serial Output Clock: The serial output data always changes when the 
serial output clock goes true. The clock then returns to zero in the center 
of the output data bit time. 

The baud (bit) rate of the data and clock is determined by audio 
channel 4 audio channel 2, or by the input clock, depending on the serial 
mode selected by bits 4, 5, and 6 of SKCTL. (See chart at end of this 
section. ) 



Serial Input: The receiving sequence begins when the hardware has 
received a complete 8 bit serial data word plus start and stop bits. This 
data is automatically transferred to the 8 bit parallel input register 
(SERIN), and the processor is interrupted to indicate an input data byte 
ready to read in SERIN. The processor must respond to this interrupt, and 
read SERIN, before the next input data word reception is complete, otherwise 
an input data "over-run 11 will occur. This over-run will be indicated by bit 
5 of SKSTAT (if bit 5 of IRQST is not RESET (true) before next input complete), 
and means input data has been lost. This bit should be tested whenever 
SERIN is read. Bit 7 of SKSTAT should also be tested to detect frame errors 
caused by extra (or missing) data bits. 



Direct Serial Input : The serial data input line can be read directly 
by the microprocessor if desired, ignoring the shift register, by reading 
bit 4 of SKSTAT. 



Bi-Directional Clock : This clock line is used to either receive a 
clock from an external clock source for clocking transmitted or received 
data, or is used to supply a clock to external devices indicating the 
transmit or reception rate. This clock line direction is determined 
by the serial mode selected by bits 4, 5, and 6 of SKCTL. (See mode chart 
at the end of this section.) Transmitted data changes on the rising edge of 
this clock. Received data is sampled on the trailing edge of this clock. 



Asynchronous Serial Input : Unclocked serial data (at an approximately 
known (+5%) rate) can be received in the asynchronous modes. The receive 
(input) shift register is clocked by audio channel 4. Channels 3 and 
4 should be used together (AUDCTL bit 3=1) for increased resolution. 
In asynchronous modes, channels 3 and 4 are reset by each start bit at the 
beginning of each serial data byte. This allows the serial data rate to be 
slightly different from the rate set by channels 3 and 4. 



Serial Mode Control : There are 6 useful modes (of the possible 8) 
controlled by bits 4, 5, and 6 of SKCTL. These are described on the next 
page. 

Note that two tone output (bit 3 of SKCTL) may be used in any of these 
modes except for the bottom pair. This is because channel 2 is used to set 
the output transmit rate and is therefore not available for one of the two 
tones. 

Note that the output clock rate is identical to the output data rate. 



Ifil 



D6 



Serial Mode Control (see also register description SKCTL) ; 
Force Break 

" SKCTL REGISTER 



D5 



I I 

I I 

I I 

I I 

I I 

I I 



D4 



D3 D2 Dl DO 



Pot scan and keyboard CTRL 
Two Tone Control 



Mode Control Bits 



A=asynchronous 



1 1 1 












Out 


Out | In | Bi-Dir | 


U D 


U J 


D4 


Rate 


Clock 


Rate 


Clock 


Comments 


10 | 


o 


o 


ext | 


ext | 


ext | 


ext 
input 


Trans. & Receive rates set by 
external clock. Also internal 
clock phase reset to zero. 


















10 I 


0 ! 


1 


ext | 


ext | 


chan 

4 I 
A 


ext 
input 


Trans, rate set by external 
clock. Receive asynch. (ch. 4) | 
(CH3 and CH4) 


















1° 


1 


10 


chan 1 
4 


chan 
4 


chan 
4 


chan 
4 

output 


Trans. & Receive rates set by 
Chan. 4. Chan. 4 output on Bi- 1 
Directional clock line. 


















0 


1 


1 


CH4 
A 


CH4 
A 


CH4 
A 


input 


Not Useful 


















11 


10 


10 


chan 

1 4 


chan 

1 4 


ext 

1 


ext 
| input 


Trans. Rate Set by Chan. 4 
Receive Rate set by External | 
Clock. | 
















1 ^ L 


1 


0 


1 


CH4 
A 


CH4 
A 


CH4 
A 


input 


Not Useful \ | 
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1 


o 


Chan 
2 


Chan | 

| 2 


Chan 

1 2 


Chan 
i 4 
Output 


Trans, rate set by chan. 2 
|Recieve rate set by chan. 4 Chan. | 
4 out on Bi-Direct. Clock line. 
























| Input 


Trans. Rate set by Chan. 2. Re- 



11 II 
I I 



II 
I 



Chan | Chan 
I 2 | 2 



L_i 



4 

A. 



| not 
| used 

J 



Two tone (bit3) not useable in these modes 
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| ceive async. (chan 3&4) Bi-Dir. | 
| Clock not used (Tri-state condi- | 
I t ion) L 



D. INTERRUPT SYSTEM ^[$0 Pfi°\°\ OS M<U4"Aj£ 



There are two basic types of interrupts defined on the microprocessor: 
NMI (non maskable interrupt) and IRQ (interrupt request). It is recommended 
that a thorough understanding of these interrupt types be acquired by 
reading all chapters concerning interrupts in the 6502 microprocessor 
programming and hardware manuals. 

In this system NMI interrupts are used for video display and reset. 
IRQ interrupts are used for serial port communication, peripheral devices, 
timers, and keyboard inputs. 



NMI Interrupts ; Even though NMI interrupts are "unmaskable" on 
the micrprocessor , this system has interrupt enable (mask) bits for NMI 
function. (Bits 6 and 7 of NMIEN) When these bits are zero NMI interrupts 
are disabled (masked) and prevented from causing a microprocessor NMI 
interrupt. (see NMIEN register description) The 3 types of NMI interrupts 
are: 

1« D7 = Instruction Interrupt (during display time^ any display 

instruction with bit 7=1 will cause this interrupt to occur 
(if enabled)^ at the start of the last video line displayed by 
that instruction.) 

2. D6 - Vertical Blank Interrupt (interrupt occurs (if enabled) at 

the beginning of the vertical blank time interval.) 

3 * D5 = Reset Button Interrupt (pushing the SYSTEM RESET button will 

cause this interrupt to occur.) 

Since any of these interrupts will cause the processor to jump to the 
same NMI address, the system also has NMI status bits which may be examined 
by the processor to determine which source caused the NMI interrupt. Bits 
5, 6, and 7 of NMIST serve this function (see NMIST register description). 
These status bits are set by the corresponding interrupt function (even if 
the interrupt is masked from the processor by NMIEN). The status bits may 
be reset together by writing to the address NMIRES. 

Two of the interrupt enable bits (bits 6 and 7 of NMIEN) are cleared 
automatically during system power turn on and therefore these NMI interrupts 
are initially disabled (masked), preventing any power turn on service routine 
from being interrupted before proper initialization of registers and pointers 
They can then be enabled by the processor whenever desired, by writing into 
bits 6 and 7 of NMIEN. Except for the reset button interrupt, they can also 
be disabled by the processor by writing a zero into bits 6 or 7 or NMIEN. 
The reset button cannot be disabled, allowing an unstoppable escape from any 
possible "hangup 11 condition. 

These NMI interrupt functions are each separated in time (to prevent 
overlaps) and converted to pulses by the system hardware, in order to supply 
NMI transitions required by the microprocessor logic. 



NOTE: Bit 5 is never disabled and therefore the Reset Button 
should not be pressed during power turn on. 
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IRQ Interrupts : IRQ interrupts are all "maskable" together by one bit 
of the status register on the microprocessor. This bit is set to the 
disable condition automatically by power turn on to prevent interrupt of 
power turn on service routines.** In addition to this processor IRQ mask 
bit, there are separate system IRQ interrupt enable bits for each IRQ 
interrupt function (bits 0 thru 7 of IRQEN). These bits are not initialized 
by power turn on, and must be initialized by the program before enabling the 
processor IRQ. The 8 types of IRQ interrupts are: 

D7 = BREAK KEY (depression of the break key) 
D6 - OTHER KEY (depression of any other key) 

D5 - SERIAL INPUT READY (Byte of serial data has been received and is 

ready to be read by the processor in SERIN register) • 
D4 = SERIAL OUTPUT NEEDED (Byte of serial data is being transmitted and 

SEROUT is ready to be written to again by the processor) • 
D3 = TRANSMISSION FINISHED (serial data transmission is finished. 

Output shift register is empty). 
D2 = TIMER #4 (audio divider #4 has counted down to zero) 
Dl = TIMER #2 (audio divider #2 has counted down to zero) 
DO ■ TIMER #1 (audio divider #1 has counted down to zero) 

In addition to the above IRQ interrupts (enabled by bits 0 through 7 of 
IRQEN and identified by status bits 0 thru 7 of IRQST) there are two more 
system IRQ interrupts which are generated over the serial bus Proceed and 
Interrupt lines. 

D7 of PACTL = peripheral "A" interrupt status bit 
DO of PACTL = peripheral "A" interrupt enable bit 
D7 of PBCTL = peripheral "B" interrupt status bit 
DO of PBCTL - peripheral "B" interrupt enable bit 

These last two interrupts are automatically disabled by power turn on, 
and their status bits are reset by reading from port A register and port B 
register. (See PORTA, PACTL, PORTB, and PBCTL Register descriptions.) 

The IRQEN register, like the NMIEN register, enables interrupts 
when its bits are 1 (logic true). The IRQST however (unlike the NMIST) has 
interrupt status bits that are normally logic true, and go to zero to 
indicate an interrupt request. The IRQST status bits are returned to logic 
true only by writing a zero into the corresponding IRQEN bit. This will 
disable the interrrupt and simultaneously set the interrupt status bit to 
one. Bit 3 of IRQST is not a latch and does not get reset by interrupt 
disable. It is zero when the serial out is empty (out finished) and true 
when it is not. 



** - NOTE: An NMI also disables the I bit. 
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INTERRUPT SUMMARY 



NAME 



FUNCTIONS 



ENABLE 



STATUS 



I STATUS 
RESET 



NMI 
INTERRUPTS 



Display | NMIEN | NMI ST | Address 

Instruction | (Bits 6 thru 7) | (Bits 5 thru 7) | NMIRES 

Vert» Blank | Normally Zero | Normally Zero | (Resets all NMI 
Reset Button 



(Disabled) 



(no interrupt) 



status together) 



KEYS 
Serial 
ports 
Timers 



IRQ 
INTERRUPTS 



j IRQEN | IRQST | Reset (to true) 

| (Bits 0 thru 7) j (Bits 0 thru 7) j By Zero in 
| zero is | Normally True | Corresponding 

j (Disabled)* | (no interrupt) | Bit of IRQEN 

(except Bit 3)* 



Peripheral 
A 



I DO of PACTL 
| Normally Zero 
(Disabled) 



I D7 of PACTL 
(Normally Zero 
(no interrupt) 



| Reset by 
| Reading PORT A 
Register 



Peripheral 
B 



I DO of PBCTL | D7 of PBCTL | Reset by 

| Normally Zero | Normally Zero | Reading PORT B 

1 (Disabled) 1 (no interrupt) | Register 



E. CONTROLLERS 



A variety of controllers can be plugged into the four jacks on the 
front of the console. This includes joysticks, paddle (pot), twelve-key 
keyboard, and light pen (when available). 

The controller ports are read through the PORTA and PORTB regisers 
and the POT and TRIG registers. TJ\e^OS^reji$i^^ 

vertical^ blank ai^ d sto res intq_ JLts own RAM l ocations. These are STICK, 
PXDm^Tthl^^ The^OS sets up PORTA AND 

PORTB for input. This is done by setting PACTL or PORTB (Port Control) 
bit 2 to a 0 (to select the direction control register), then writing all 
O's to the desired port. PACTL (PBCTL) bit 2 is then changed back to 
a 1, allowing the program to read from the port. The ports can also be 
set up for output by writing l's instead of O's while the direction control 
mode is selected. 



Joysticks t The joysticks have four switches, one each for right (R) , 
left (L), back (B) and forward (F) . 

These switches are read through PORTA and PORTB. A fifth switch is 
activated by pressing the red trigger button. The trigger buttons are 
read from TRIGO through TRIG3. A value of 0 indicates that a button has 
been pressed and a 1 indicates that it has not been pressed. 
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The TRIG registers are normally read directly, but they can be used 
in a latched mode. Writing a zero to bit 2 of GRACTL disables the latches 
and sets them to I. Writing a 1 to bit 2 enables the latches. If a joy- 
stick trigger button is pushed at any time while bit 2 of GRACTL is 1 
the latch value will change to zero and stay that way. A program can 
use this to determine whether the joystick trigger buttons have ever been 
pressed during a certain period of time. 

Paddles : The paddles come in pairs, so eight paddles can be connected 
to the four jacks. The paddles are read by storing into POTGO, then 
reading the POT registers at least 228 lines later. The values range from 0 
(with the paddle turned to the right) to 228 (paddle turned counter-clockwise) 
The value indicates how many TV lines it takes to charge up the capacitor 
which is the series with the potentiometer. Turning the knob to the right 
lowers the resistance, so the capacitor charges up quickly. Turning the 
knob to the left increases the resistance and the charging time. The 
capacitor dump transistors are used to discharge the capacitors so that a 
new reading can be mode. The POTGO command clears the counters and turns 
off the dump transistors to allow the capacitors to charge up. The ALLPOT 
register contains one bit for each paddle. When the capacitor has charged 
up to the threshold value the ALLPOT bit changes fron one to zero and the 
POT register contains the correct readings. Bit 2 of SKCTL (Serial Port 
Control) enables fast pot scan. In this mode, It takes only two scan lines 
to charge up the capacitors to the maximum level instead of 228 lines. Bit 
2 is first set to 0 to dump the capacitors. Then Bit 2 is set to 1 to start 
the pot scan. The fast pot scan is not as accurate as the normal scan mode. 
Bit 2 of SKCTL must be set to 0 to use normal scan mode. Otherwise, the 
capacitors will never dump. Note that some paddles have a range smaller 
than 0 to 228 due to differences in the pots. The left and right paddle 
triggers for each paddle pair are read from the left and right bits for the 
corresponding joystick (PORTA or PORTB). 

Keyboard Controllers : Each keyboard controller has a twelve-key pad 
and plugs into a joystick controller port. The first step in using the 
keyboard is to select a row by setting the port direction to output and 
writing a 0 to the bit in the PORTA or PORTB register which selects the 
desired row (see PORTA, SECTION III). The other rows should have 1's 
written to them. Columns are read through the POT and TRIG registers (see 
controller PORT PINOUT chart in section III). Appendix H of the BASIC 
Reference Manual contains a Basic program which reads the controllers. The 
first and second columns of the keyboard use the same pins as the pots for 
the paddle controllers, so they are read by reading the POT (or PADDL) 
registers. When a button is pushed, the pot line is grounded, so the pot 
capacitors never charge up to the threshold level and the reading is 228 
(the maximum). When the button in the selected row and column is not pushed 
the capacitor is connected to +5V through a relatively small resistor, 
giving a POT value of about 2 (this may vary). Since the reading is not 
critical, the fast pot scan mode can be used, so that only a 2 line wait is 
required between selecting the row and reading the POT register. The 
convention has been adopted of comparing the POT reading with 10 (decimal). 
If is it greater than 10 then the button has been pressed. The third 
column is read through the joystick trigger line, so it works just like a 
joystick trigger (0=button is pressed, l=not pressed). 
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Light Pen ; A light pen is a device that can detect the electron beam 
as It sweeps across the TV screen. It is used to point directly at an image 
on the TV display. Applications include selecting menu items and drawing 
lines. The ATARI 400/800 hardware was designed so that a light pen can be 
plugged into any of the joystick controller ports (see end of section 
1 1 1 ) • 

.x^.o^f 11 any ° ne ° f the J°y stick trigger lines (pin 6) is pulled low, the 
ANTIC chip takes the current VCOUNT value and stores it in PENV. The 
horizontal color clock value (0-227 decimal) is stored in PENH. The least 
significant bit is inaccurate and should be ignored. Since there are a 
number of delays involved in displaying the data and changing the light 
pen register, each system must be cal brated. Software which uses the 
light pen should contain a user-interactive calibration routine. For 
example, the user could point the light pen at a crosshair in the center 
of the screen and the program could compute the required horizontal offset. 
PENH will wrap around from 227 to 0 near the right hand edge of a standard 
width display because of the delay. The pen will not work if it is pointed 
at a black area of the screen, since the electron beam is turned off. It is 
a good idea to read two (or more) values and average them, since the user 
will probably not hold the pen perfectly steady. 
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V. HARDWARE REGISTER LISTS 
A. ADDRESS ORDER. 



CTIA ADDRESSES 





WRITE 


READ 


Address 


Name 


Description 


Name 


Description 


DOFF 










f 
| 


> REPEAT AS BELOW 


7 MORE TIMES 


D020 










D01F 


CONSOL 


Write Consol SW.Port 


CONSOL 


Read Consol SW. Port 


DOIE 


HITCLR 


Collision Clear 






DOID 


GRACTL 


Graphic Control 






DOIC 


VDELAY 


Vert. Delay 






D91B 


PRIOR 


Priority Select 






DOIA 


COLBK 


Col-lum Bkgnd 






D019 


COLPF3 


Color-lum of 3 






D018 


COLPF2 


Playfield 2 






D017 


COLPF1 


Playfield 1 






D016 


COLPFO 


Playfield 0 






D015 


COLPM3 


Color-lum of 3 






D014 


COLPM2 


Player-Missile 2 


PAL 


READ PAL/NTSC bits 


D013 


COLPM1 


Player-Missile 1 


TRIG 3 


Read Joystick 


D012 


COLPMO 


Player-Missile 0 


TRIG 2 


Trigger 


DOll 


GRAFM 


Graphics All Missiles 


TRIG1 


Buttons 


DOIO 


GRAFP3 


Graphics Player 3 


TRIGO 




DOOF 


GRAF P 2 


Graphics Player 2 


P3PL 


Read Player 


DOOE 


GRAFP1 


Graphics Player 1 


P2PL 


to Player 


DOOD 


GRAFPO 


Graphics Player 0 


P1PL 


Collisions 


DOOC 


SIZEM 


Size All Missiles 


POPL 




DOOB 


SIZEP3 


Size Player 3 


M3PL 


Read Missile 


DOOA 


SIZEP2 


Size Player 2 


M2PL 


To Player 


D009 


SIZEP1 


Size Player 1 


M1PL 


Collisions 


D008 


SIZEPO 


Size Player 0 


MOPL 




D007 


HPOSM3 


Horz. Posit. Missile 3 


P3PF 


Read Player 


D006 


HPOSM2 


Horz. Posit. Missile 2 


P2PF 


To Playfield 


D005 


HPOSM1 


Horz. Posit. Missile 1 


P1PF 


Collisions 


D004 


HPOSMO 


Horz. Posit. Missile 0 


POPF 


D003 


HPOSP3 


Horz. Posit. Player 3 


M3PF 


Read Missile 


D002 


HPOSP2 


Horz. Posit. Player 2 


M2PF 


To Playfield 


DOOl 


HPOSP1 


Horz. Posit. Player 1 


M1PF 


Collisions 


DOOO 


HPOSPO 


Horz. Posit. Player 0 


MOPF 





V.l 



ANTIC ADDRESSES 



Address 


Name | Description 


Name | Description 


D4FF 
i 

D410 


J REPEAT (AS BELOW) 


15 MORE TIMES 


D40F 


NMIRES 


Reset NMT 

ivtoc l mix 

Interrupt Status 

NMT Tntprnin!' 


NMIST 


iNri± xnterrupu 
Status Register 


D40E 


NMIEN 


ENABLE 






D40D 






PENV 

X Xjll V 


Light Pen Register 


D40C 







PENH 


Light Pen Register 


D40B 






VPOTTNT 

V Kj\J U 11 X 


Vertical Line 


D40A 


WSYNC 


Wait for HBLANK 

Q vn p Vi T*on "f Qm 
i_/ y liu 11 jl uuxo ixi 






D409 


CHBASE 


Character Base 
Address Red 






D408 










D407 


PMBASE 


Player-Missile Base 
Address Register 






D406 










D405 


VSCROL 


Vertical Scroll 
Register 






D404 


HSCROL 


Horizontal Scroll 
Register 






D403 


DLISTH 


Display List 
Pointer (High Byte) 






D402 


DLISTL 


Display List 
Pointer (Low Byte) 






D401 


CHACTL 


Character Control 
Register 






D400 


DMACTL 1 


DMA Control 
Register 
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POKEY ADDRESSES 





WRITE 


READ 


Name I Description 


Name Description 


D2FF 

t 

D210 


J REPEAT (AS BELOW) 


15 MORE TIMES 


D20F 


SKCTLS 


Serial Port 4 Key 
Control 


SKSTAT 


Serial Port 4 Key 
Status Register 


D20E 


IROEN 


IRQ Interrupt 
Enable 


IRQST 


IRQ Interrupt 
Status Register 


D20D 


SEROUT 


Serial Port 
Output Reg. 




Serial Port 
Input Register 


D20C 










D20B 


POTGO 


Start Pot Scan 
Sequence 




Vertical Line 


D20A 


SKRES 


Reset Status 
(SKSTAT) 


RANDOM 


Random Numb 
Generator 


D209 


STIMER 


Start Timers 


KBCODE 


Keyboard Code 


DzUo 


AUDCTL 


Audio Control 


ATT T»/"\T» 

ALLPOT 


Read 8 Line Pot 
Port State 


t\ o n "7 
D207 


AUDC4 


Audio Channel 4 
Control 


POT 7 


Read the 
value of 
each POT 


D206 


AUDF4 


Audio Channel 4 
Frequency 


POT 6 


D205 


AUDC3 


Audio Channel 4 
Control 


POT 5 


DZU4 


AUDF3 


Audio Channel 3 
Frequency 


POT 4 


D203 


AUDC2 


Audio Channel 2 
Control 


POT 3 


D202 


AUDF2 


Audio Channel 2 
Frequency 


POT 2 


D201 


AUDC1 


Audio Channel 1 
Control 


POT 1 


D200 


AUDF1 


Audio Channel 1 
Frequency 


POT 0 




Addres s 
D3FF 

D304 

D303 

D302 



D301 



D300 



Repeat as shown below many times 



PBCTL 



PACTL 



PORTB 



PORTB 



PORTA 



PORTA 



PORT B CONTROL 



PORT A CONTROL 



Direction Register 
If PBCTL Bit 2-0 
(otherwise) 



Jack 2 & Jack 3 
If Direction Bits 
Are 1 * 



Direction Register 
If PACTL Bit 2=0 
(Otherwise) 



Jack 0 & Jack 1 
If Direction Bits 
Are 1 * 




PBCTL 
PACTL 



PORTB 



PORTB 



PORTA 



PORTA 



Same as write 



Same as write 



Jack 2 & Jack 3 
If Direction Bits 
Are 0 * 



Same as write 



Jack 0 & Jack 1 
If Direction Bits 
Are 0 * 



NOTE: Output data is retained in Jack Output Registers. 
If direction bits are true, a read of the jacks 
will read old data from these registers. 
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III. HARDWARE REGISTERS 



This section lists the hardware registers and Operating System (OS) 
shadow registers. 



In the following descriptions, true always refers to a bit whose value 

is 1. 



A. PAL (D014) 




D3 


D2 


Dl 


1 


1 


1 


0 


0 


0 



NTSC (US TV) 
PAL (European TV) 

This byte can be read by a program to determine which type of system 
the program is running on. 

B. INTERRUPT CONTROL 



NMIEN (Non Maskable Interrupt Enable) (D40E) ; This address writes data 
to the NMI interrupt enable bits. 

0 - disabled (masked) 



1 


■ enabled 


1 1 


Not 


D7 I D6 I 


Used 



D7 Display List Instruction Interrupt Enable. This bit is 

cleared by Power Reset, and may be set or cleared by the 
processor. 

D6 Vertical Blank Interrupt Enable. This bit is cleared by Power 
Reset, and may be set or cleared by the processor. 

SYSTEM RESET Button Interrupt 

This interrupt is always enabled. The SYSTEM RESET button should 
not be pressed during power turn on. 

(Set to hex 40 by OS IRQ code.) 
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NMIST (Non Maskable Interrupt Status) (D40F) : This address read the NMI 
Status Register (Read by OS NMI code) . 



0 = no interrupt 

1 = interrupt 



1 1 1 


Not 


D7 1 D6 1 D5 


Used 



D7 This bit identifies an NMI interrupt caused by bit 7 of a 
Display List Instruction. 

D6 This bit identifies an NMI interrupt caused by the beginning 
of vertical blank. 

D5 This bit identifies an NMI interrupt caused by the SYSTEM 
RESET button. 



NMI RES (NMI Status Register Reset ) (D40F) : This write address resets 
the Non Maskable Interrupt Status Register (NMIST). 



Not 
Used 



( Written by OS NMI code.) 

IRQST (IRQ Interrupt Status) (D20E) ; This address reads the data from 
the IRQ Interrupt Status Register. 

0 = Interrupt 

1 = No Interrupt 



I I I I I I I 
D7 I D6 | D5 1 D4 1 D3 1 D2 I Dl I DO 



D7 




0 


Break Key Interrupt 


D6 




0 


Other Key Interrupt 


D5 




0 


Serial Input Data Ready Interrupt 


D4 




0 


Serial Output Data Needed Interrupt 


D3 




0 


Serial Output (Byte) Transmission Finished Interrupt * 


D2 




0 


Timer 4 Interrupt 


Dl 




0 


Timer 2 Interrupt 


DO 




0 


Timer 1 Interrupt 



NOTE: Used for generation of 2 stop bits. See IRQ description 
in section II (no direct reset on bit 3). 
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IRQEN (IRQ Interrupt Enable) (D20E) : This address writes data to the IRQ 
Interrupt Enable bits. 

0 - disable, corresponding IRQST bit is set to 1 

1 ■ enable 



i i i i i i i 

D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



D7 
D6 
D5 
D4 
D3 
D2 
Dl 
DO 



Break Key Interrupt Enable 

Other Key Interrupt Enable 

Serial Input Data Ready Interrupt Enable 

Serial Output Data Needed Interrupt Enable 

Serial Out Transmission Finished Interrupt Enable 

Timer 4 Interrupt Enable 

Timer 2 Interrupt Enable 

Timer 1 Interrupt Enable 



OS SHADOW: POKMSK (hex 10) 

Use AND's and OR's to change one bit in POKMSK without affecting 
the others. Store the desired value in both IRQEN and POKMSK. 



C. TV LINE CONTROL 



VCOUNT (V ertical Counter) (D40B ) ; This address reads the Vertical TV 
Line Counter (8 most significant bits). 

|3P & 



o 



I I I I I I I 

D7 1 D6 I D5 I D4 I D3 I D2 I Dl I DO 



V8 V7 V6 V5 V4 V3 V2 VI 



VO not read. 
VO Two line 
resolution 
supplied. 



WSYNC (Wait for Hor izontal Blank Synchronism - i.e. wait unti l start of 
next TV line. ) (D40A) ; ~ 



not used 



This address sets a latch that pulls down on the RDY line to the 
microprocessor, causing it to wait until this latch is automatically reset 
by the beginning of horizontal blank. Display list interrupts may be 
delayed by 1 line if WSYNC is used. (Used by OS keyboard click routine.) 
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D. GRAPHICS CONTROL 



DMACTL (Direct Memory Access Control) (D400) t This address writes data 
into the DMA Control Register. 

1 Q i 1 1 1 

Not | I I I I I 

Used I D5 I D4 I D3 I D2 I Dl 1 DO 



D5 




1 


Enable instruction fetch DMA 


r D4 


- 


1 


1 Line P/M resolution 






0 


2 line P/M resolution 


D3 




1 


Enable Player DMA 


D2 




1 


Enable Missile DMA 


Dl.DO 




0 


0 No Playfield DMA 






0 


1 Narrow Playfield DMA 
(128 Color Clocks) 






1 


0 Standard Playfield DMA 
(160 Color Clocks) 






1 


1 Wide Playfield DMA 



(192 Color Clocks) 
See GRACTL. OS Shadow: SDMCTL (22F) default value hex 22 



GRACTL (Graphics Control) (D01D) ; This address writes data to the 
Graphic Control Register. 



Not 


1 1 1 


Used 


I D2 1 Dl 1 DO 



D2 = 1 Enable latches on TRIGO - TRIG3 inputs (latches are 

cleared and TR1G0 - TRIG 3 act as normal inputs when this 
control bit is zero) • 

Dl - 1 Enable Player DMA to Player Graphics Registers. 

DO = 1 Enable Missile DMA to Missile Graphics Registers. 

DMA is enabled by setting bits in both DMACTL and GRACTL. Setting 
DMACTL only will result in cycles being stolen but no display will be 
generated. 
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CHACTL (C haracter Control) (D401) ; This address writes data into the 
Character Control Register. 



Not 


i i i 


Used 


1 D2 1 Dl 1 DO 



D2 Character Vertical Reflect Bit. This bit is sampled at the 
beginning of each line of characters. If true it causes the 
line of characters to reflect (invert) vertically (for upside 
down characters). 

Dl Character Video Invert Flag (used for 40 Character Mode 

only) . If bit 7 of character code is true this flag causes 
that character to be blue on white (if normal colors are 
white on blue) • 

DO Character Blank (Blink) Flag (used for 40 Character Mode 

only) . If bit 7 of character code is true this flag causes 
that character to blank. Blinking characters are produced by 
setting bit 7 of the characters to 1, then periodically 
changing DO of CHACTL. 

OS SHADOW: CHACT (2F3) 



DLISTL ( D isplay List Low )(D402) ; This address writes data into the 
low byte of the Display List Counter. 

i i i i i i i | 

D7 | D6 | D5 I D4 I D3 I D2 I Dl 1 DO 

(Display 
List 
Counter 
Bit 
Position. 



DLISTH (Display List High)(D403) : This address writes data into the 
high byte of the Display List Counter. 

i i i i i r i 1 

D7 1 D6 I D5 I D4 I D3 I D2 I Dl I DO 

C Display 

15 14 13 12 11 10 9 8 J List 

( Counter 

Bit 
VPosition. 

OS SHADOW: SDLSTH (HEX 231) 

The Display List is a list of display instructions in memory. These 
instructions are addressed by the Display List Counter. Loading these 
registers defines the address of the beginning of the Display List. (See 
sections I and II.) 

Note: The top 6 bits are latches only and have no count capability, therefore 
the display list can not cross a IK byte memory boundary unless a jump 
instruction is used. 
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DLISTL and DLISTH should be changed only during vertical blank or with 
DMA disabled. Otherwise, the screen may roll. Bit 7 of NMIEN must be set 
in order to receive display list interrupts. 



CHBASE (Character Address Base Register) (D409) ; This address writes 
data into the Character Address Base Register. The data specifies the most 
significant byte (MSB) of the address of the desired character set (see 
section II). Note that the last 1 or 2 bits are assumed to be 0. 

40 Character Modes 



| D7 ID6 1D5 1D4 |D3 |D2 \ 



CHBASE 



1 



0 



(l5 114 113 Jj.2 111 110 | 9 I 8 I 7"I" 6 J 5 1 4 Lj^ 

Base Address Char Name Line Counter 



5 



20 Character Modes 
|D7 ID6 1D5 ID4 |D3 |D2 IDI j *1 



CHBASE 



(15 114 113 112^111 UP I 9 1^8 I 7 I 6^5 I 4 j 3 2 | ^ L-Oj 
Base Address Char Name Line Counter 

OS SHADOW: CHBAS (2F4) 



PMBASE (Player-Missile Address Base Register) (D407) : This address 
writes data into the Player-Missile Address Base Register. The data 
specifies the MSB of the address of the player and missile DMA data (see 
section II). 

One Line Resolution 
not used I 



lD7 [j)6 |D5 1D4 1D3 



PMBASE 




Base Address 



Player-Missile 
Select 



Player-Missile Scan 
Counters 



|P7 ID6 |D5 ID4 |D3 |D2 J 



Two Line Resolution 

PMBASE 



fl5 114 113 112 111 110 9 18 17, 


6 


5 


4 I 


3 


2 


1 







Base Address 



Player-Missile 
Select 



Player-Missile Scan 
Counter 



* = Not Used 



HSCROL (Horizontal Scroll Register) (D404) : This address writes data 
into the Horizontal Scroll Register. Only playfield is scrolled, not 
players and missiles. 



not used 



I I I I 

1 D3 I D2 I Dl I DO 



xn 



0 to 15 color 
clock right shifts 

The display is shifted to the right by the number of color clocks 
specified by HSCROL for each display list instruction that contains a 1 
its HSCROL Flag bit (bit 4 of instruction byte). 

When horizontal scrolling is enabled, more bytes of^ data are needed. 
For a narrow playfield (see DMACTL bits 1 and 0) there should be the same\ 
number of bytes per line as for standard playfield with no scrolling. ^ , 

Similarly, for standard playfield use the same number of bytes as for the yocA 
wide playfield. For wide playfield, there is no change in the number of ^^Z^lP^t'^ 
bytes and background color is shifted in. 




VSCROL (Vertical Scroll Register) (D405) : 
Vertical Scroll Register. 



This address writes data into 



not used 


1 1 

1 D2 I Dl 


1 

1 DO 


8 


line display modes 




not used 


1 1 1 
1 D3 I D2 | Dl 


1 

| DO 


16 


line display modes 





The display is scrolled upward by the number of lines specified in 
the VSCROL register for each display list instruction that contains a 1 in 
its VSCROL Flag bit (bit 5 of instruction byte) . The scrolled area will 
terminate with the first instruction having a zero in bit 5. (see section 
II for more details). 



PRIOR (Priority) (D01B) ; This address writes data into the Priority 
Control Register. 



i i i i i i i 

D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 




r A 
5 



I 



CAlA 

I 0 C\ ku/lu^ 



Multiple Color Player Enable. 

This bit causes the logical "or" function of the bits of 
the colors of Player 0 with Player 1, and also of Player 2 
with Player 3. This permits overlapping the position of 2 
players with a choice of 3 colors in the overlapped region 
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D4 Fifth Player Enable , 

This bit causes all missiles to assume the color of Playfield 
Type 3. (C0LPF3) • This allows missiles to be positioned 
together with a common color for use as a fifth player. 

D3, D2, Dl, Priority Select (Mutually Exclusive). 

& DO These bits select one of 4 types of priority. Objects with 

higher priority will appear to move in front of objects 
with lower priority. 



A 



Higher 
Priority 



D3=l 

p PFO 
L-PF1 

PO 

PI 

P2 

P3 — ' 
I — PF2 
IPF3 + P5 

BAK 



D2=l 



PFO 

PF1 
PF2 

PF3 +_P5 
PO 
PI 
P2 
P3_ 
BAK 



Dl = l 

PC-] 
PI -J 

— PFO 
PF1 
PF2 

PF3 + 5 
P2 
P3 
BAK 



] 



D0=1 

PO -1 
PI 
P2 

. P3 _1 

PFO 
FF1 
PF2 

PF3 + 5 
BAK 



0001 
0010 

100° 



\ 



NOTE : The use of Priority bits in a "non-exclusive" mode (more than 1 

bit true) will result in objects (whose priorities are in conflict) 
turning BLACK in the overlap region. 
EXAMPLE : PRIOR code - 1010 This will black P0 or PI if they are over 

PFO or PF1. It will also black P2 or P3 if they are over PF2 or 
PF3. In the one-color 40 character modes, the luminance of a 
pixel in a character is determined by C0LPF1, regardless of the 
priority. If a higher priority player or missile overlaps the 
character then the color is determined by the player's color. 

OS SHADOW: GPRI0R (26F) 



COLPFO - C0LPF3 (Playfield Color) (D016, D017, D018, D019) : These 
addresses write data to the Playfield Color-Lum Registers. 



D7 



I I I I I ! I 

I D6 | D5 | D4 1 D3 I D2 1 Dl 1 DO 

(see COLBK for bit assignment) 



OS SHADOWS: COLOR0 - 3 (2C4-2C7) 
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COLBK (Background Color) (D01A) ; This address writes data to the 
Background Color-Lum Register. 



Color 



Luminance 



i 

D7 I D6 



I I 

D5 I D4 



X 



X 



0 


0 


0 


0 


0 


0 


0 


1 


0 


0 


1 


0 


0 


0 


1 


1 


0 


1 


0 


0 


0 


1 


0 


1 


0 


1 




" 0 


0 


1 


1 


1 


1 


0 


0 


0 


1 


0 


0 


1 


1 


0 


1 


0 


1 


0 


1 


1 


1 


1 


0 


0 


1 


1 


0 


1 


1 


1 


1 


0 


1 


1 


1 


1 



D3 



I I 
D2 I Dl 



0 
0 



0 
0 

ETC. 
1 



0 
1 



Not 
Used 



Zero Luminance (black) 



Max • Luminance (white) 




(Gold) i 
Orang 
Red-Oran 
Pink H 
Purple 5 
Purple-Blue 
Blue 7 
Blue ? 
Light-Blue ^ 
Turquoise A 
Green-Blue 8 
Green C 
Yellow-Green ^ 
Orange-Green E 
Light-Orange F 



yel( 



- m 



OS SHADOW: C0L0R4 (2C8) 



COL 

H 



? 



T 

V 

A 

C 



E. PLAYERS AND MISSILES 

DMACTL, GRACTL, PMBASE and PRIOR also affect players' and missiles. 

COLPMO - C0LPM3 (Player-Missile Color) (D012. D013. D014» D015 ) : These 
addresses write to the Player-Missile Color-Lum Registers. Missiles have 
the same color-lum as their player unless missiles are used as a 5th player 
(see bit 4 of PRIOR). A 5th player missile gets its color from C0LPF3. 




(see COLBK for bit assignments) 

OS SHADOWS: PCOLRO - 3 (2C0-2C3) 

GRAFPO - GRAFP3 (Player Graphics Registers): (PO POOD, Pi DOPE, P2 POOF, 

P3 D010) : These addresses write data directly into the Player Graphics 
Registers, independent of PMA. If PMA is enabled then the graphics registers 
will be loaded automatically from the memory area specified by PMBASE (see 
page II. 3). V ^lfil& 




Left / Right 

Player on TV Screen 




A1 GRAFM (Missile Graphics Registers) ( nni 1 ) ; This address writes data 
directly into the Missile Graphics Register, independent of DMA. 

^vmH" ko woryu - u«*e p/ 

SIZEPO - SIZEP3 (Pl ayer Size) (PO D008. PI DQQ9 . P2 DQQA. P3 DO OR) • 
These addresses write data into the Player Size Control Registers 

*• — 




Not 






Used 


1 Dl 


DO 


1 


0 


0 




' 0 


1 




— 1 


0 




1 


1 



Horizontal Size 
Register (Player) 

Normal Size 

(8 color clocks wide) 
Twice Normal Size 

(16 color clocks wide) 
Normal Size 

4 Times Normal Size 
(32 color clocks wide) 

With normal size objects, each bit in the graphics register corresponds 
to one color clock. For larger objects, each bit is extended over more than 
one color clock. \ 

SIZEM (Missile Size)(D0QC): This address writes data into the Missile 
Size Control Register. 



1 

D7 I D6 


1 

D5 I D4 


1 

D3 I D2 


1 

Dl | DO 


M3 


M2 


Ml 


MO 



Horizontal Size 
Register (Missile) 



0 
0 
1 




0 
1 
0 

1 



Normal Size 

(2 color clocks wide) 
Twice Normal Size 

(4 color clocks wide) 
Normal Size 



4 Times Normal Size 
(8 color clocks wide) 



HPOSPO - HP0SP3 (Plave r Horizontal Position) (PO DQOQ. pi DQQl. P 2 DQQ2 
, P3 D003) : These addresses write data into the Player Horizontal Position 
Register (see display diagram in section IV). The horizontal positon value 
determines the color clock location of the left edge of the object. Hex 30 
is the left edge of a standard width screen. Hex DO is the right edge of a 
standard screen. B 



! i i i i \ i — 

D7 I D6 I D5 I D4 I D3 I D2 I Dl | nn 
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HPOSMO - HPOSM3 (Missile Horizontal Position) (MO D004, Ml D005, 
M2 D006, M3 D007) t These addresses write data into the Missile Horizontal 
Position Registers (see HPOSPO description). 



I I I I I I I 
D7 I D6 I D5 1 D4 1 D3 I D2 1 Dl I DO 



VP EL AY (Vertical Delay) (D01C) : This address writes data into the 
Vertical Delay Register. 




P3 P2 PI PO M3 M2 Ml MO 




o 
a 

o 



VDELAY is used to give one-line resolution in the vertical po- 
sitioning of an object when the 2-line resolution display is enabled. 
Setting a bit in VDELAY to 1 moves the corresponding object down by one 
TV line. 

If player-missile DMA is enabled then changing the vertical location 
of an object by more than one line is accomplished by moving bits around 
in the memory map. If DMA is disabled then the vertical location can be 
set up by assembly language code which stores data into the graphics 
registers at the desired line. 

MOPF, M1PF, M2PF» M3PF (Missile to Playfield Collisions) (D000 , D001, 
D002, D003) : These addresses read Missile to Playfield Collisions 
A 1 bit means that a collision has been detected since the last /HITCLR 



Not Used 
(zero forced) 



I I I I 

1 D3 I D2 I Dl 1 DO 




0 Playfield Type 



l>ooo 
\>oo\ 

00 3 



Q } 




















-> 





















MO 

Ml 
M3 



POPF, P1PF, P2PF, P3PF (Player to Playfield Collisions) (D004 , 
D005, D006, D007) : These addresses read Player to Playfield Collisions 



Not Used 
(zero forced) 



i i i i 

I D3 I D2 I Dl I DO 



Playfield Type 



i>ooti 




MOPL, M1PL, M2PL, M3PL (Missile to Player Collision) (D008 , D009, 
DOOA, DOOB) ; These addresses read Missile to Player Collisions. 



Not Used 
(zero forced) 



I I I -I 

| D3 | D2 | Dl | DO 
















o 






1 0 


F 





3 2 10 Player Number 

POPL, P1PL, P^PL, P3PL (Player to Player Collisions) (D00C , D00D , DOPE , 
D00F) : These addresses read Player to Player Collisions 



Not Used I I I I 

(zero forced) I D3 1 D2 I Dl I DO 




s>ooc 









o 




* 


















JL 





P 3 



3 2 10 Player Number 
(Player 0 against Player 0 is always a zero). Etc. 
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3 2 \ o 



HITCLR^ (Collision "HIT" Clear) DO i E 

This write address clears all collision,bits described 
above. 



Not 




Used 





F. AUDIO 

0 %V b* 

AUDCTL (Audio Contro l) (D208): This address writes data into the Audio 
Mode Control Register. (Also see SKCTL two-tone bit 3 and notes). 



! i i i i ! i — 

D7 | D6 I D5 I D4 I D3 I D2 I Dl I DO 



D7 Change 17 bit poly into a 9 bit below poly. 

D6 Clock Channel 1 with 1.79 MHZ, instead of 64 KHZ. * 

D5 Clock Channel 3 with 1.79 MHZ, instead of 64 KHZ. 

D4 Clock Channel 2 with Channel 1, instead of 64 KHZ (16 BIT). \ 

D3 Clock Channel 4 with Channel 3, instead of 64 KHZ (16 BIT). \) 

D2 Insert Hi Pass Filter in Channel 1, clocked by Channel 3. 
(See section II.) 

Dl Insert Hi Pass Filter in Channel 2, clocked by Channel 4. 

DO Change Normal 64 KHZ frequency, into 15 KHZ. 



Exact Frequencies: The frequencies given above are approximate. The 
Exact Frequency (fin) that clocks the divide by N counters is given below 
(NTSC only, PAL different). 



FIN 


FIN 


(Approximate) 


(Exact) 


1.79 MHZ 


1.78979 MHZ 


64 KHZ 


63.9210 KHZ 


15 KHZ 


15.6999 KHZ 


The Normal Formula for output freqi 


Fout = 


Fin/2N 



Use modified formula for fout 



- Use normal formula for fout 



is: 



Where N = The binary number in the frequency register (AUDF) , plus 1 (N=AUDF+1) 
The MODIFIED FORMULA should be used when Fin = 1 . 79 MHZ and a more exact result 
is desired: 



Fout 



Fin 



2 (AUDF 4- M) 



Where: 



M = 4 if 8 bit counter (AUDCTL bit 3 or 4 = 0) 
M - 7 if 16 bit counter (AUDCTL bit 3 or 4 - 1) 
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bf\SlC Sound fV$ 



AUDF1 » AUDF2, AUDF3, AUDF4 (Audio Frequency) (D200. D202. D204. D206) 
These addresses write data into each of the four Audio Frequency Control 
Registers. Each register controls a divide by W N M counter. 




Note: "N" is one greater 
than the binary number 
in Audio Frequency 
Register AUDF(X). 



out 



N 



HI C 



P3 



AUDC1, AUDC2, AUDC3, AUDC4 (Audio Channel Control) (D201 , D203. 
D205, D207): These addresses write data into each of the four Audio Control 
Registers. Each Register controls the noise content and volume of the 
corresponding Audio Channel. 




^ 

<t JIJSJ 





Noise Content or Distortion Volume 



HEX 


D7 


1 

| D6 


1 

1 D5 


1 

1 D4 


1 1 1 
D3 1 D2 I Dl I DO 


0 


0 


0 


0 


0 




2 


0 


0 


1 


o - 




4 


0 


1 


0 


0 




6 


0 


1 


1 


0 






1 


0 


0 


0 






1 


X 


1 


0 




c 


1 


1 


0 


0 




1 


X 


X 


X 


1 




0 










0 0 0 0 


8 










10 0 0 


F 










1111 



Divisor "N" set 
by audio frequency 
register. 



- 17 BIT poly - 5 BIT 

poly - N 

^ 5 BIT poly - iT^T" 



] 



( 



r 




- 4 BIT poly - 5 BIT 
poly --fl ; 



- 5 BIT poly - N - 2 




Pure Tone - N - 2 




Force Outpu 
(Volume only 



- Lowest Volume (Off) 

- Half Volume 

- Highest Volume 
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5 °#^k\ ~S I 



$-» Cur ft = * -rt> Ho, ^ tvi 



fro-ro too 



PITCH VALUES FOR THE MUSICAL NOTES-AUDCTL =0, AUDC - hex AX 



HIGH 
NOTES 



LOW 
NOTES 



AUDF 



STIMER (Start Timer) (D209) : This write address resets all audio 
frequency dividers to their "AUDF" value. These dividers generate timer 
interrupts when they count down to zero (if enabled by IRQEN) . (also see 
IRQST) 



not used 



RANDOM (Random Number Generator ) (D20A) : This address reads the high 
order 8 bits of a 17 bit polynomial counter (9 bit, if bit 7 of AUDCTL=1). 



I I I I I I I 
D7 I D6 I D5 1 D4 I D3 1 D2 I Dl I DO 
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G. KEYBOARD AND SPEAKER 



CONSOL (Console Switch Port) (D01F) ; This address reads or writes data 
from the console switches and indicators. (Set to 8 by OS Vertical Blank 
code. ) 



Not Used | | | 

(zero forced) 1 D3 I D2 I Dl 1 DO 



Hex 08 should be written to this address before reading the switches 



Ones written will pull down on the 



switch line. 



CONSOL Bit Assignment: 



DO Game Start 

Dl Game Select 

D2 Option Select 

D3 Loudspeaker 



- 0 means switch pressed. 

- should be held at 1 
except when writing 0 
momentarily. OS writes a 
1 during vertical blank. 



KBCODE (Keyboard Code)(D209) : This address reads the Keyboard Code, 
and is usually read in response to a Keyboard Interrupt (IRQ and bits 6 or 7 
of IRQST). See IRQEN for information on enabling keyboard interrupts. See 
SKCTL bits 1 and 0 for key scan and debounce enable. 




D7 - Control Key 
D6 = Shift Key 



Read by OS into shadow CH when key is hit. The OS has a get character 
function which converts the keycode to ATASCII (Atari ASCII). 
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KEYCODE TO ATASCII CONVERSION 



KEY 
CODE 

\J \J U J-i 


KFY 

X VJUi X 

CAP 


T. .C. . 


it .r . 


CTRT 

O i XVi-i 




Y PV 

pnnp 


PAP 
OAT 


T C 
Li • L» • 


tt r 1 




00 


T 

J-i 


6C 


4C 


nr 




z u 


> 


9r 

ZL. 




uu 


01 


J 


6A 

w ATX 


4A 


OA 




2 1 

Z. X 


^PAPF 

Oi Lj 


90 

Z,\J 


90 
z u 


90 
zu 


02 


• 


3B 


3A 


7B 




22 


• 


2F 

Z. Hi 




fiO 


03 












21 

Z- J 


N 


6F 


AF 


OP 


04 












24 










05 


K 


6B 


4B 


0B 




2 5 

Z. J 


M 


6n 


An 


on 

UJJ 


06 


I 


2B 


5C 


1 F 

X Hi 




96 

Z u 




9F 
zr 


7P 




07 


* 


2A 


5E 


IF 

x r 




9 7 
z / 








+ 


08 


n 


6F 
u r 


AF 


OF 

ur 




?a 
zo 


p 


79 


^ 9 


1 9 
1Z 


HQ 

u y 












9 Q 
Ly 










OA 


p 

x 


70 
/ vj 


SO 
j \j 


X u 




9 A 
Z A 


p 


03 




VD 


0B 


TT 

u 


/ -j 


-f -j 


1 S 

X J 




9R 

ZD 


V 
I 


7Q 


SQ 


1 Q 

x y 


oc 


RFT 




9R 

^X> 


OR 




9P 

ZL» 


TAR 
1AJ5 


1 r 


QP 


Qt? 


0D 


T 

X 


\j y 


AQ 


OQ 

VJ ^7 




9n 

Z JJ 


T 
1 


7 A 


DH 


1 /• 


0E 




2D 

z. u 


5F 


1 r 

X v> 




9F 

Z Lj 


U 
w 


7 7 


«;7 


1 7 
1 / 


OF 

\J L 




in 


7P 


i n 

X JJ 




9F 
zr 


n 

H 


7 1 

/ 1 


t: i 
D 1 


i i 
1 1 


1 0 


v 

V 


76 


J u 


1 fi 

X D 




9.0 


Q 


Oy 


9 ft 
Z O 




1 1 












1 1 
J X 










1 9 

1 z 


p 


67 


A7 


07 




79 


u 


70 


9 Q 

zy 




1 J 












77 


7 


*X 7 


9 7 

Z / 




1 A 

X H 












7A 


•D APVQ 

DAL»J\o 


7P 


QP 

y\j 


r XL 


1 s 

X J 


D 


62 

vj Z. 


A2 

*+ z. 


w z 






Q 
O 


z> O 


AO 




16 


x 


78 


58 


18 

X *~> 




36 


< 




7D 


7n 

/ JJ 


17 


z 


7A 


5A 


1A 




37 


> 


3E 


9D 


FF 


18 


4 


34 


24 






38 


F 


66 


46 


06 


19 












39 


H 


68 


48 


08 


1A 


3 


33 


23 


* 




3A 


D 


64 


44 


04 


IB 


6 


36 


26 






3B 










1C 


ESC 


IB 


IB 


IB 




3C 


CAPS 


* 


* 


* 


ID 


5 


35 


25 






3D 


6 


67 


47 


07 


IE 


2 


32 


22 


FD 




3E 


S 


73 


53 


13 


IF 


1 


31 


21 


* 




3F 


A 


61 


41 


01 



* = special handling 
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H. SERIAL PORT (see peripheral connector on console) 



SKCTL (Serial Port control) (D20F) : This address writes data into the 
register that controls the configuation of the serial port, and also the 
Fast Pot Scan and Keyboard Enable. 

(Bits are normally zero 
and perform the functions 
shown below when true.) 



I I I I I I I 
D7 1 D6 I D5 1 D4 I D3 I D2 I Dl I DO 



D7 Force Break (force serial output to zero (space))* 

D5 > Serial Port Mode Control (see mode chart at end of 
D4y Serial port description, page 11.34). 

D3 Two Tone (Serial output transmitted as two tone signal instead of 
logic true/false. ) 

D2 Fast Pot (Fast Pot Scan. The Pot Scan Counter completes its 
sequence in two TV line times instead of one frame time. The 
capacitor dump transistors are completely disabled.) 

Dl Enable Key Scan (Enables Keyboard Scanning circuit) 

DO Enable Debounce (Enables Keyboard Debounce circuits) 

D0-D1 (Both Zero) Initialize (State used for testing and initializing 
chip) ** 

OS SHADOW: SSKCTL (hex 232) 

The OS enables key scan and debounce and may change the other bits for 
different I/O operations. In particular, an aborted cassette operation may 
leave the two tone bit in the true state, causing undesirable audio signals. 
This may be corrected by writing hex 13 to both SKCTL and SSKCTL after doing 
I/O and/or before modifying the audio registers. 



* NOTE: When powered on, serial port output may stay low even if this bit 

is cleared. To get S.P. high (mark), send a byte out (recommend 
00 or FF) . 

**N0TE: There is no original power on state. Pokey has no reset pin. 



III. 17 



SKSTAT (Serial Port-Keyboard Status) (D20F) : This address reads the 
status register giving information about the serial port and keyboard. 



I I I I I I I 
D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



(Bits are normally true 
and provide the following 
information when zero.) 



TV "7 

D7 




0 




Serial Data Input Frame Error 




D6 


= 


0 


= 


Serial Data Input Over-run 


Latches 












must bp 

*HU 0 Ip L/C 


D5 


= 


0 


SB 


Keyboard Over-run 


reset = 1 












(SKRES) 


D4 




0 




Direct from Serial Input Port 














(D5 and D6 are set to 


D3 




0 




Shift Key Depressed 


zero when new data 












and same bit of IRQST 


D2 




0 




Last Key is Still Depressed 


is zero) 


Dl 




0 




Serial Input Shift Register Busy 




DO 




1 




Not Used (Logic True) 





SKRES (Reset above Status Register) (D20A) ; This write address resets 
bits 7, 6, and 5 of the Serial Port-Keyboard Status Register to 1. 



not used 



SERIN (Serial Input Data)(D20D) : This address reads the 8 bit parallel 
holding register that is loaded when a full byte of serial input data has 
been received. This address is usually read in response to a serial data in 
interrupt (IRQ and bit 5 of IRQST). Also see IRQEN. 

i i i i i i i 

D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 
Serial I/O Port Connector Pinout : 




1. 


Clock In 


2. 


Clock Out 


3. 


Data In to computer 


4. 


GND 


5. 


Data Out of Computer 


6. 


GND 


7. 


Command 


8. 


Motor Control 


9. 


Proceed 


10. 


+5 / Ready 


11. 


Audio In 


12. 


+12 


13. 


Interrupt 







See serial port description in OS manual for more details. 
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SEROUT (Serial Output Data) (D2QD) : This address writes to the 8 bit 
holding register that is transferred to the output serial shift 
register when a full byte of serial output data has been transmitted. This 
address is usually written in response to a serial data out interrupt (IRQ 
and bit 4 of IRQST). F v 




I. CONTROLLER PORTS (front of console) 



PORTA (Port A)(D300): This address reads or writes data from Player 0 
and Player 1 controller jacks if bit 2 of PACTL is tru^. This address 
writes to the direction control register if bit 2 of PACTL is zero. I/O for 
both ports (A and B) goes through a 6520/6820 ' * 

Data Register-Addressed if bit : 2oX~P-ACTL is 1. 



Joystick Operation 



i i i i i in 

D7 1 D6 I D5 I D4 I D3 1 D2 I Dl | DO 



Right 



Back 



Left 



Right 



Back 



0=Switch pressed 
l=Switch not pressed 



Fwd. 



Left 



Fwd. 
/ 



Stickl 


StickO 


(Jack 2) 


(Jack 1) 


Paddle Operation 


1 1 1 1 


1 1 1 


D7 1 D6 1 D5 D4 D3 1 D2 1 Dl 1 DO 


PTRIG2 


PTRIGO 


1 PTRIG3 


1 PTRIG 1 



0=Switch pressed 
l=Switch not pressed 



Keyboard Controller Operation 



I I I I I I | 
D7 I D6 1 D 5 I D4 1 D3 I D2 I Dl I DO 



Top Row *\ 
2nd Row I 
3rd Row / 
4th Row ) 



Top Row "N 
2nd Row I 
3rd Row / 
4rd Row ) 



Jack 1 



Jack 2 



Directio n Control Register-Addressed if b it 2 of pJcTL 



I I I I I I I 
D7 I D6 I D5 I D4 I D3 I D2 I Dl | DO 




is 0 



Each bit corresponds to a jack pin 



0= input 
l=output 



OS SHADOWS: STICKO (hex 278), STICK1 (279), PTRIGO-3 (27C-27F 



PACTL (Port A Control) (D302) ; This address writes or reads data from 
the Port A Control Register- ^ $ 3 £ fc y JtfQ Co** 1 * 



I I I I I I I 
D7 I D6 I D5 I D4 I D3 I D2 I Dl 1 DO 



Port A Control 
Register 

[ 0 1 1 X X 0 X Set up register as shown 

(X ■ described below) 

D7 - (Read only ) Peripheral A Interrupt Status Bit. Serial 

bus Proceed line. (Reset by reading Port A Register. 

Set by Peripheral A Interrupt.) 
D3 - Peripheral Motor Control line on serial bus (write). 

(0 = On 1 = Off) 
D2 - Controls Port A addressing described above (write). 

(1 = Port A Register 0 = Direction Control Register). 
DO - Peripheral A Interrupt Enable Bit. (Write) 1 - Enable. 

Reset by power turn-on or processor. Set by Processor. 



PORTB (Port B)(D301) : This address reads or writes data from Player 2 
and Player 3 controller jacks if bit 2 of PBCTL is true. This address 
writes to the direction control register if bit 2 of PBCTL is zero. I/O for 
both ports (A and B) goes through a 6520/6820. 

Data Register-Addressed if bit 2 of PBCTL is 1 




Right 



Back 



Right 



Back 



Left 



Fwd. 



Left 



Fwd. 



Stick3 
(Jack 4) 



Stick2 
(Jack 3) 



0=Switch pressed 
l=Switch not pressed 



Paddle Operation 



1 I 1 1 1 1 I 

D7 1 D6 D5 1 D4 1 D3 D2 Dl DO 




1 — PTRIG6 
PTRIG7 


1 — PTRIG4 
PTRIG5 



0=Switch pressed 
l=Switch not pressed 




Top Row^ 
2nd Row I 
3rd Row f 
4th Row J 



Top Row 
2nd Row 
3rd Row 
4rd Row 



Jack 3 
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Direction Control Register-Addressed if b it 2 of PBCTL is 0 



I I I I I I I 
D7 I D6 I D5 I D4 I D3 I D2 I Dl I DO 



Each bit corresponds to a jack pin 

0=input 
l=output 

OS SHADOWS: STICK2 (hex 27A), STICK3 (27B), PTRIG4-7 (280-283) 



PBCTL (Port B Contr ol) (D303) ; This address writes or reads data from 
the Port B Control Register. 



Read Only 



I I 
D7 I D6 I D5 



I I I I I 

I D4 I D3 I D2 1 Dl I DO 



D7 



D3 
D2 
DO 



0 



Port B Control 

Register 
Set up register as 
shown (X=Described 
below) 



(Read only ) Peripheral B Interrupt Status Bit. Serial 
bus Interrupt line. Reset by Reading Port B Register. 
Set by Peripheral B Interrupt. 

Peripheral Command Identification. Serial bus Command 
Line. 

Controls Port B addressing described above. 

(1= Port B Register 0 = Direction Control Register) 

Peripheral B Interrupt Enable Bit. 1 = Enable. 

Reset by power turn-on or processor. Set by processor. 

(Set to hex 3C by OS IRQ code) 



POT0 - P0 T7 (Pot Values) (D200-D207) : These addresses read the value (0 
to 228) of 8 pots (paddle controllers) connected to the 8 lines pot port. 
The paddle controllers are numbered from left to right when facing the 
console keyboard. Turning the paddle knob clockwise results in decreasing 
pot values. The values are valid only after 228 TV lines following the 
"POTGO" command described below or after ALLPOT changes. 



I I I I I I I 

D7 I D6 I D5 I D4 I D3 1 D2 I Dl 1 DO 

Each Pot Value (0-228) 



OS SHADOWS: PADDLO - 7 (hex 270-277) 
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ALLPOT (All Pot Lines Simultaneously) (D208) ; This address reads the 
present state of the 8 line pot port. 



Capacitor dump transitors must be turned off by either going to fast 
pot scan mode (bit 2 of SKCTL) or starting pot scan (POTGO). 




Pot number: 
7 6 5 



0 = Pot register value is valid. 

1 = Pot register value is not valid. 



8 Pot Line States 



POTGO (Start Pot Scan)(D20B) : 




This write address starts the pot scan sequence. The pot values 
(POTO - P0T7) should be read first. This write strobe is then used causing 
the following sequence. 

1. Scan Counter cleared to zero. 

2. Capacitor dump transistors turned off. 

3. Scan Counter begins counting. 

4. Counter value captured in each of 8 registers (POTO - 
P0T7) as each pot line crosses trigger voltage. 

5. Counter reaches 228, capacitor dump transistors turned 
on. 

(Written to by OS vertical blank code) 



TBJG0, TRIG1, TRIG2, TR1G3 (Trigger Ports) (0 D010, 1 D011, 2 D012, 
3~ D013) ; These addresses read port pins normally connected to the joystick 
controller trigger buttons. 



Not Used 


i 


0 = button pressed 


(Zero Forced) 


| DO 


1 = button not pressed 



OS SHADOWS: STRIGO-3 (hex 284-287) 



1 : 1^ 



NOTE: 



TR1G0 thru TRIG 3 are normally read directly by the microprocessor. 
However, if bit 2 of GRACTL is 1, these inputs are latched whenever 
they go to logic zero. These latches are reset (true) when bit 2 
of GRACTL is set to 0. 
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PENH (Light Pen Horizontal Color Clock Position) (D40C) : This address 
reads the Horizontal Light Pen Register (based on the horizontal color clock 
counter in hardware). The values range from 0 to decimal 227. Wraparound 
occurs when the pen if near the right edge of a standard-width screen. PENH 
and PENV are modified when any of the joystick trigger lines is pulled low. 




H7 H6 H5 H4 H3 H2 
OS SHADOW: LPENH (hex 234) 



HI HO 



PENV (Light Pen Vertical TV Line Position) (D40D) ; This address reads 
the Vertical Light Pen Register (8 most significant bits, same as VCOUNT). 




LP8 



0 LPO not read. Two line 
resolution supplied • 



OS SHADOW: LPENV (hex 235) 



Front Panel (Controller) Jacks as I/O Parts 

PIA (6520/6820) 

Out: TTL levels, 1 load 
In : TTL levels, 1 load 



Port A Circuit (typical): 



6520 


(A) 


220 . 




Port 





" AA/ ^t .001 

J 



Jack 



Port B Circuit (typical): 

o+5 
4.7K 



6520 


(B) 


220 . 




Port 





'VV VV- 

T 



.001 



Jack 



"Trigger" Port Circuit (typical): 



CTIA Trig 



220 ^yy 



.001 



T 
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Controller Port Pinout: 



Male 
(console) 



Female 
(connector) 






\ 1 2 


3 4 5 / 


\ 5 4 3 

\ 


2 1 / 

/ 






\ 6 
\ 6 


"7 Q O / 

7 8 9 / 


\ 9 8 


7 6 / 
















PIN 


JOYSTICK 


Controllers 
PADDLE (POT) 


KEYBOARD 


HARDWARE 
REGISTERS 


OS 

VARIABLES 


1 


Forward 




Top Row* 


Bit 0 or 4** 


Bit 0*** 


2 


Back 




2nd Row* 


Bit 1 or 5** 


Bit 1*** 


3 


Left 


A(Lef t)Trigger 


3rd Row* 


Bit 2 or 6** 


PTRIG0,2,4,6 


4 


Right 


B(Right)Trigger 


Bottom Row* 


Bit 3 or 7** 


Bit 2*** 
PTRIG1,3,5,7 








1st Column 


POT 1,3,5,7 


Bit 3*** 
PADDL 1,3,5,7 


6 


Trigger Button 




3rd Column 


TRIGO, 1,2,3 


STRIGO, 1,2,3 


7 




+5 


+5 






8 


GND 


GND 








9 




POTA (Left) 


2nd Column 


POT 0,2,4,6 


PADDL0,2,4,6j 



* Write 
** PORTA or PORTB 
*** STICK 0, 1, 2 or 3 



3 




• 
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IV. SAMPLE PROGRAM 



This assembly language program illustrates the use of players, missiles, 
and display lists. The diagram on the next page shows what the display 
looks like and which objects are used. The comments in the program listing 
describe how it works. 
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J— 












UAJ 












•H 








♦H ~ 




f 








rr 






iJ- 










rn 








r/i 












CD 




c 


CD 






c I 




. h 








• H 




i 








T 1 






r— t 
























CO 












iO 






— 




JJ 


»u 


















C/j 




C/j 


C/j 






C/J 




C/j 


GO 


1 




cj 




o 


o 






f — 

M - 




f 








CJ 




CJ 


u 


1 








w 
















o 


cij 


CD 






uj 


•H 


r- 

l— i 


J. 




i. 
H 


t . 
M 


4_J 


• r- 1 


CD 

SIX 




flj 


VA/ 






1 1 




i i 


ij 
4— 1 


CD 




f i 




« 

f ) 


CJ 


*> 








vu 


rrt 














CM 


eg 


co 




CO 


CO 


O 


i— i 


X! 










PQ 


u 


o 


o 


U 














C 


<r 


O v£> 








w 




CnJ t— 1 


oo 


r— 1 


1 — 1 


J/ 















3 

►J 

CO 



co 
CJ 

w 
sc 
u 




PQ 



CJ 
CT> 



CJ 



> 



in 



> h cn m 

i_/ X £ x 



CJ 
CO 



00 

coy 



c 




o 




•H 




J~» 




•H 




CO 




o 


• 


pD 






X 




Q) 


CO 








c 




o 


CO 


N 


CD 


•H 




U 




o 


CO 


pa 


> 


0) 




rH 


CD 


•H 




CO 


CO 


CO 


•H 


•H 


60 


» 


CD 






U 




CD 
















&4 





C/5 




fa 




w 




O 


>^ 








<C 


M 




H 


►J 




w 




Pm 




H 


< 


CO 




1*. 


H 


M 


p 


< 


CO 


Q 
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in 

Ul 

CE 
D 
O 
UJ 



CD 
00 



W 

z 

a 
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o 

o 



ON 
CD 
<<J- 
O 
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in 

Ul 

CL 
D 
D 
UJ 





cc 








in 


-J 








D 


CD 








h" 










cc 


_J 








H 


S 








Ln 


u 








>-> 










e 


ix 








z 


Ul 

> 








u 




w 






o 


XT 


TE 








UJ 

z 


> 

CD 




















M 






00 


6 




in 










Ul UJ 








a: 










UJ 


Ui QG > 




CL 


UJ 




_j cr cd 




2 > 




Z 


CD Z 




Ct 


_j 


~i 


CE UJ M 




£L 




o 
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u 
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Z 
»— i 


D 
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CE 
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U 
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i 


ID 


ct in u _i ui 




w 
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3 


Z 
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> 


_J 




Ul 
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E 
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<3 
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or 
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CE 
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a. 


o 
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_l 
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_j 
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uj oc i- 

in o w z 
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> 

CE 

b! 

in 
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CM 

z 

CE 
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22 
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10 



Z 
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-J 
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-» 
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© 
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UJ 
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o 
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IV. 11 



B. ALPHABETICAL ORDER 



Hardware Register 



Address 



Name 



Description 



Hex 



Dec 



OS Shadow 



Address 



Name 



Hex 



Dec 



ALLPOT 

AUDC1 

AUDC2 

AUDC3 

AUDC4 



Read 8 line Pot Port State 
Audio Channel 1 Control 
Audio Channel 2 Control 
Audio Channel 3 Control 
Audio Channel 4 Control 



D208 
D201 
D203 
D205 
D207 



53768 
53761 
53763 
53765 
53767 



AUDCTL 

AUDF1 

AUDF2 

AUDF3 

AUDF4 



Audio Control 
Audio Channel 1 Frequency 
Audio Channel 2 Frequency 
Audio Channel 3 Frequency 
Audio Channel 4 Frequency 



D208 
D200 
D202 
D204 
D206 



53768 
53760 
53762 
53764 
53766 



CHACTL 
CHBASE 
C COLBK 
XCOLPF0 
I C0LPF1 
I C0LPF2 
\ C0LPF3 
COLPM0 
COLPM1 
C0LPM2 



Character Control 
Character base address 
Color-Luminance of Background 
Color Luminance of Playfield 0 
Color Luminance of Playfield 1 



D401 
D409 
D01A 
D016 
D017 



54273 
54281 
53274 
53270 
53271 



CHART 
CHBAS 
C0L0R4 
COLOR0 
COLOR 1 



2F3 
2F4 
2C8 
2C4 
2C5 



755 
756 4- 
712 
708 ^ 
709 



— 



Color Luminance of Playfield 2 

Color Luminance of Playfield 3 

Color Luminance of Player-Missile 0 

Color Luminance of Player-Missile 1 

Color Luminance of Player-Missile 2 



D018 
D019 
D012 
D013 
D014 



53272 
53273 
53266 
53267 
53268 



C0L0R2 
C0L0R3 
PCOLR0 
PC0LR1 
PC0LR2 



2C6 
2C7 
2C0 
2C1 
2C2 



710 
711 
704 
705 
706 



COLPM3 
CONSOL 
•> DLISTH 
# DLISTL 
ft DMACTL 



Color Luminance of Player-Missile 3 
Console Switch Port 
Display List Pointer (high byte) 
Display List Pointer (low byte) 
Direct Memory Access (DMA) Control 



D015 
D01F 
D403 
D402 
D400 



53269 
53279 
54275 
54274 
54272 



PC0LR3 
Set to 
SDLSTH 
SDL STL 
SDMCTL 



2C3 



707 



8 during VBLANK 



231 
230 
22F 



561 

560 t>>62r <j,* 3 <e u 

559., 



eP $ 



GRACTL 
GRAFM 
GRAFP0 
GRAFP1 
GRAF P 2 



Graphic Control 
Graphics for all Missiles 
Graphics for Player 0 
Graphics for Player 1 
Graphics for Player 2 



D01D 
>0il 

D00D 
D00E 
D00F 



53277 
53265 
53261 
53262 
53263 



GRAF P 3 
HITCLR 
THPOSMO 
J HP0SM1 
HP0SM2 



Graphics for Player 3 
Colission Clear 

Horizontal Position of Missile 0 
Horizontal Position of Missile 1 
Horizontal Position of Missile 2 



D010 
D01E 
D004 
D005 
D006 



53264 
53278 
53252 
53253 
53254 



HP0SM3 
HPOSP0 
HP0SP1 
HP0SP2 
HP0SP3 



Horizontal Position of Missile 3 
Horizontal Position of Player 0 
Horizontal Position of Player 1 
Horizontal Position of Player 2 
Horizontal Position of Player 3 



D007 
D000 
D001 
D002 
D003 



53255 
53248 
53249 
53250 
53251 



i>.s i -200 



HSCROL 
IRQEN 
IRQST 
KBCODE 
( MOPF 



Horizontal Scroll 

Interrupt Request (IRQ) Enable 

IRQ Status 

Keyboard Code 

Missile 0 to Playfield Collisions 



D404 
D20E 
D20E 
D209 
D000 



54276 
53774 
53774 
53769 
53248 



POKMSK 



CH 



10 



2FC 



16 



764 



V M0PL 
/ M1PF 

M1PL 
/ M2PF 

M2PL 



Missile 0 to Player Collisions 
Missile 1 to Playfield Collisions 
Missile 1 to Player Collisions 
Missile 2 to Playfield Collisions 
Missile 2 to Player Collisions 



D008 
D001 
D009 
D002 
D00A 



53256 
53249 
53257 
53250 
53258 



Name 
f M3PF 
M3PL 
NMIEN 
NMIRES 
NMIST 



POPF 
POPL 
/P1PF 
-P1PL 
■' P2PF 
V P2PL 
P3PF 
P3PL 
PACTL 
PAL 



( 



PBCTL 
PENH 
PENV 
PMBASE 
PORTA 



L 



PORTB 

POTO 

POT1 

POT2 

POT3 



POT4 
POT5 
POT6 
POT 7 
POTGO 



PRIOR 
RANDOM 
SERIN 
SEROUT 
SIZEM 
C~ SIZEPO 
1 SIZEP1 
SIZEP2 
SIZEP3 
SKCTL 



Hardware Register 



Description 



Missile 3 to Playfield Collisions 
Missile 3 to Player 
Non-Maskable Interrupt (NMI) Enable 
NMI reset 
NMI Status 



Player 0 to Playfield Collisions 
Player 0 to Player Collisions 
Player 1 to Playfield Collisions 
Player 1 to Player Collisions 
Player 2 to Playfield Collisions 



Player 2 to Player Collisions 
Player 3 to Playfield Collisions 
Player 3 to Player Collisions 
Port A Control 
PAL/NTSC indictor 



Port B Control 

Light Pen Horizontal Position 
Light Pen Vertical Position 
Player Missile Base Address 
Port A ffibrte * Z s+«ok£ 



Port A 
Pot 0 
Pot 1 
Pot 2 
Pot 3 



Pot 4 
Pot 5 
Pot 6 

Pot 7 (right paddle controller) 
Start POT Scan Sequence 



SKREST 
SKSTAT 
STIMER 
TRIGO 
TRIG1 



L 

CTRIG2 
TRIG3T 
• VCOUNT 
VDELAY 
VSCROL 



WSYNC 



Priority Select 
Random number generator 
Serial Port Input 
Serial Port output 
Sizes for all missiles 



Size of Player 0 
Size of Player 1 
Size of Player 2 
Size of Player 3 
Serial Port Control 



Reset Serial Port Status (SKSTAT) 
Serial Port Status 
Start Timer 

Joystick Controller Trigger 0 
Joystick Controller Trigger 1 



Joystick Controller Trigger 2 
Joystick Controller Trigger 3 
Vertical Line Counter 
Verical Delay 
Vertical Scroll 



Wait for Horizontal Sync 



Address 
Hex Dec 



D003 
DOOB 
D40E 
D40F 
D40F 



D004 
DOOC 
D005 
DOOD 
D006 



DOOE 
D007 
DOOF 
D302 
D014 



D303 
D40C 
D40D 
D407 
D300 



D301 
D200 
D201 
D202 
D203 



D204 
D205 
D206 
D207 
D20B 



D01B 
D20A 
D20E 
D20D 
DOOC 



D008 
D009 
DOOA 
DOOB 
D20F 



D20A 
D20F 
D209 
D010 
D011 



D012 
D013 
D40B 
D01C 
D405 



D40A 



53251 
53259 
54286 
54287 
54287 



53252 
53260 
53253 
53261 
53254 



53262 
53255 
53263 
54018 
53268 



54019 
54284 
54285 
54279 
54016 



54017 
53760 
53761 
53762 
53763 



53764 
53765 
53766 
53767 
53771 



53275 
53770 
53774 
53773 
53260 



53256 
53257 
53258 
53259 
53775 



53770 
53775 
53769 
53264 
53265 



OS Shadow 
Address 



Name 



Hex 



Dec 



Set to $40 by IRQ code 
written to by NMI code 
read by NMI code 




Set to $3C by IRQ Code 
I I 



r 



Set to 

LPENH 

LPENV 



$3C by 
234 
235 



STICK0.1 



STICK2, 

PADDL0 

PADDL1 

PADDL2 

PADDL3 



PADDL4 
PADDL5 
PADDL6 
PADDL7 
WRITTEN 



IRQ Code 
564 
565 



278^279 



27A,27B 
270, 
271 
2 72 
273 



274 
275 
276 
277 



3f i/^' 

632.633 jpooxxxv 



634,635 

624 

625 

626 

627 



628 
629 
630 
631 



DURING VBLANK 



GPRIOR 



S SKCTL 



53266 
53267 
54283 
54276 
54277 



54282 



STRIG0 
STRIGL 



STRIG2 
STRIG3 



26F 



232 



284 
285 



286 
287 



Used by keyboard 
click routine 



623 



562 



644 
645 



646 
647 
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VI. FIGURES 
A. MEMORY MAP 



ADDRESS 


FUNCTION 


SIZE 


FFFF 


Operating System 
And 

Math Routines 


10K 


D800 






DOOO-D7FF 
CFFF 


Hardware Addresses 

Keserved tor Future 
O.S. expansion 


2K 
4K 


BFFF 


ROM Cartridge 

• 




8000 


(Colleen left and right 
slot and Candy single 
slot all address to 
this space) 


16K 


7FFF 


RAM 

Expansion * 




2000 






1FFF 


RAM initially 
supplied in the 
product 


8K 



RAM expansion can actually exten to BFFF. However, the ROM cartridges 
will deselect the RAM. Deselection occurs on 8K boundaries. Atari 400 
units are RAM expandable only at the factory. They can accept RAM up 
to 2FFF (16K) when fully extended. 

3 7 



VI. 1 



USE OF 



APPENDIX A 
PLAYER/FISSILE 
WITH BASIC 



GRAPHICS 



The ATARI ® 400/800 ™ Hardware Manual should be read first to understand 
the details of the Player/Missile Graphics. 

To enable the P/M Graphics from BASIC the following procedure 
can be used:* 

1. Generate the playfield, either with a GRAPHICS call or build 
a custom display list with a series of POKE statements. 

2. Enable P/M DMA control by a POKE 559 with either a 62 for 
single line resolution players or a 46 for double line 
resolution players. 

3. There are four players and four missiles (or five players if 
the four missiles are combined into one player). Each of 
these has a horizontal position register that controls its 
horizontal position on the screen. The registers and their 
locations are as follows: 



ADDRESS HORIZONTAL POSITION OF 

53248 Player 0 

53249 Player 1 

53250 Player 2 

53251 Player 3 

53252 Missile 1 

53253 Missile 2 

53254 Missile 3 

53255 Missile 4 



The horizontal positions can range on the playfield between 41 
and 200. So POKE 53249,120 will move Player 1 to the middle 
of the screen. 



*NOTE : All number references are decimal. 



Use of Player/Missile Graphics 
with BASIC, cont. 



4. Each player (and its missile) has a color register which 

determines its color. These registers can be controlled by 
poking to the following locations: 



Thus a POKE 706,200 will color player 2 green. 

5. The P/M bit information (those bytes which actually describe 
the shape of the player) must be stored in an area where it 
will not interfere with BASIC or the operating system. It 
must also start at a 2K memory boundary if single line 
resolution players are used, or a IK boundary for double line 
resolution players . 

6. The page number (i.e. number of 256 byte sections of memory) 
for the starting address of the P/M information obtained in 
step 5 is poked into location 54279. 

7. Enable the P/M DMA by a POKE 53277,3. 

8. The starting address of each player is obtained by multiplying 
the number obtained in step 6 by 256 and then adding the 
offset indicated in P/M memory configuration table. 

9. The vertical position of the player is determined by its 
location in memory. After the initial offset is obtained in 
step 8, its height may be defined. Its range on the playfield 
is from 32 to 223 in single line resolution and from 16 to 111 
in double line resolution. By adding the desired height to 
the initial offset, the absolute address of each player is 
found. The appropriate bit information for the player can now 
be poked into this address. 



ADDRESS 



COLOR OF 



704 
705 
706 
707 
711 



P/M 0 
P/M 1 
P/M 2 
P/M 3 



fifth player (if enabled) 



JU2- 
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(9, cont.) 



Example to Generate a rectangular box player, eigh 
clocks wide and four lines high in immediate mode. 



STEP TYPE 



1 



-3tf 

AO 
50 
60 
10 



9 



GRAPHICS 8 



POKE 559 , 62 
POKE 53248 f 120 



RESULT 

Setup Mode 8 Play field r— 

Enable P/M DMA single li ne\ < l £ 

Set horizontal position £ i>$4Q C *7 i 



POKE 704,83 



I = PEEK (106)0 £ 

POKE 54279, I 

POKE 53277,3 . 

J = I * 256 + 1674 

POKE J + 125,255 
POKE J + 126,129 
POKE J + 127,129 
POKE J + 128,255 



Set color to pink 1 < ^8 
Get P/M base address .. 
Store in ^sg^£ggi4tei| Q T^M-C? 
Enable P/OHT ^C $>g\ 1>< 3 [ 
Get player starting address 
Draw player on screen J 





1 is 
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+0 



0) 

CM 

o 



+384 
+512 
+640 
+768 
+896 
+1024 



DMACTL 
bit D4=0 



DMACTL 
bit D4=l 



start at 

PMBASE*O024 



start at 

PMBASE * -2©48-£3 U 



8 bits wide -- 

384 bytes 
unused 



+0 



M3 M2 Ml !M0 



Player 0 



Player 1 



Player 2 



Player 3 



128 bytes 
per player 




double line 
resolution 



*---8 bits wide - 

768 bytes 
unused 



M3 



M2 



Ml 



M0 



Player 0 



Player 1 



Player 2 



Player 3 



256 bytes 
per player 



V 

single line 
resolution 



too 



ZOO 



+768 



+1024 



boo 



+1280 



+1536 



70o 



+1792 



+2048 



00 

o 

CM 



PLAYER-MISSILE 

Memory 
Configuration 



Absolute address 
\ determined by 

PMBASE. 

Relative address 
shown along sides 
of maps. 

Each Player-Missile 
section (128 bytes 
in single line, 256 
bytes in double line) 
maps directly onto 
the total height of 
£ TV screen. 

4J 

£> 



r 
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APPENDIX B 

MIXING GRAPHICS MODES 



I . GENERAL 

This procedure describes how to mix several graphic modes on 
the TV screen at the same time using BASIC commands. Each graphics 
mode has a different number of scan lines per "Mode Line" (one line 
of a graphics mode). The TV screen must consist of 192 scan lines, 
so when mixing modes, they must be combined in' such a way as to get 
192 scan lines. This is accomplished by modifying the Display 
Lis t . 

When a graphics mode is set on the computer, the 0/S allocates 
RAM space for the graphics mode, then builds the display list 
adjacent to the graphics RAM, and sets a pointer to the beginning 
of the display list. Each "mode line" is constructed from a "mode 
byte" in the display list that determines how many scan lines in 
each mode line. The display list describes the screen display from 
top to bottom. 

A Display List must be built for the "max RAM mode" (the 
graphics mode that requires the most RAM) then modified with POKES 
to mix the other modes with it. This "max RAM mode" cannot be a 
split screen mode (text window) , therefore "max RAM mode" +16 must 
be used. If the max RAM mode will be at the top of the screen, then 
the "LMS byte" (load memory scan byte) at the top of the Display 
List will already be correct. If not, the "LMS byte" will have 
to be modif ied . 

The Display List is modified by POKING a new mode byte for 
each mode line that is not a max RAM mode line. At the end of the 
display list is a JUMP instruction pointing to the top of the 
Display list. When the Display List is modified, the JUMP instruc- 
tion must be placed immediately after the last mode byte. 

Example #1 will be used throughout this procedure to 
illustrate each step. 



NORMAL 



TV 6CR££N 



W\OQ\FI 60 



96 



moDE 7 



76 L)N£$ 



TOTAL = /92 



woDC 



WOOE 7 

01 S Y>L A V 
LIST 







DEC 


I 


Cmd) 


77 




LO 




MI 


2 


Ctf eft 


)3 


3 


(tft>> 


13 


H 




13 



Mope 7 

76 LINES 



V 

96 





13 




13 


C<*o) 


13 


(Ml) 


CS 


LO 


HX 



IU 

UWE5 



1 



mooe 1 


4, < 9-^ 






mode. 7 




^6? l in es 




MOVE. 7. 







1 



TOT A L = H 



5C« N 
UN (5 # 



fAO0\f I ED 

>v\ODE. 7 

Dlf> PL fW 
LIST 



» 1 



4 

6 



moot l 

<© LIMES 



2 

3 
4 



rooot 7 
^56 i. in as 



7 

J 

? 

61 
62 



moo£ 2. 



4 3 



Ju w p 



i 3 S- 
l<*2 





DEC 


LINE- 


f46) 






to 




HI 








/C 




c 


*H 




& 


32 






UO 




& 






13 


iT<2< 


(<5D) 




-S\2 




1 


Ceo') 


)3 






13 


(uo 


(0 7) 


7 


1 76 


(07) 


7 






6sS" 




LO 




HX 
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Mixing Graphics Modes, cont. 



I I • PROCEDURE TO SET UP SCREEN IN MIXED MODES : 

1. Select modes desired, then look up which mode is the max 
RAM mode from table #2. 

example: modes selected - mode 1, mode 7, mode 2 

mode 7 = max RAM mode 

2. Use table #1 to calculate the number of mode lines such 
that the total number of scan lines = 192. 



examp 1 e : 



I scan | 
lines 



# mode 
mode line mode 



scan 
lines 







line 




1 


6 


8 


48 


7 


56 


2 


112 


2 


2 


16 


32 



192 



TOTAL 



If the max RAM mode is at the top of the screen, then skip 
this step: Calculate the LMS byte by setting the left 
nibble to 4, then use table #1 to find the right nibble for 
the graphics mode at the top of the screen. 



examp 1 e : 



1. left nibble = 4 

2. right nibble for mode 1 

3. LMS byte = 46 (HEX) 



Calculate the mode byte for each mode. Set the left nibble 
to 0, use table #1 to find the right nibble for each mode. 



example : 



Mo d e 



I Left | 
I Nibblej 

I I 



Right I Mode 
Nibble! Byte 
I (HEX) 











1 


0 


6 


06 


7 


0 


1 S 1 


OD 


2 


0 


7 J 


07 
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II 



PROCEDURE TO SET UP SCREEN IN MIXED MODES , cont.: 
5. Convert all bytes to decimal, 
examp 1 e : 



Bvt e 


(HEX) 


DEC 


LMS 


46 


70 


Mode 1 


06 


6 


Mode 7 


OD 


13 


Mode 2 


07 


7 



6. Execute a graphics call on the computer using the max RAM 
mo de (4-16) . 

example: GRAPHICS 7+16 

7. PEEK the Display List pointer and use it to calculate a 
variable labelled "START M • 

example: START - PEEK(560) + PEEK(561) * 256 + 4 

8. If the max RAM mode is at the top of the screen, then skip 
this step: Poke the LMS byte to location START- 1 • 



9. 



example: POKE START-1,70 

Every mode line requires a mode byte in the Display List in 
the same order as the mode lines appear on the screen. The 
mode bytes must be POKED into the Display List at location 
START 4- offset, where offset = mode line 



Examp 1 e : 



MODE 1 



MODE LINE * 

2 
3 
4 
5 
6 



POKE INSTRUCTION 

POKE START 4- 2,6 

POKE START 4- 3,6 

POKE START 4- 4,6 

POKE START + 5,6 

POKE START 4- 6,6 



MODE 7 
MODE 2 



see note for mode 7 (max RAM mode) 



63 
64 



POKE START + 63,7 
POKE START 4- 64,7 



NOTE: The Display List will already be correct for the max RAM 
mode, therefore its mode bytes do not need to be POKEd. 
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II- PROCEDURE TO SET UP SCREEN IN MIXED MODES , cont.: 

10. POKE the JUMP instruction followed by the LO byte, then the 
HI byte into the Display List. The offset for the JUMP 
POKE is the last mode line # + 1, for LO byte it is + 2, 
for HI byte it is + 3. 

example: (last mode line # was 64) 

REMARK POKE INSTRUCTION 

JUMP POKE START '+ 65,65 

LO BYTE POKE START + 66, PEEK(560) 

HI BYTE POKE START + 67, PEEK(561) 



III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES 



If the mode line #'s of a mode on the screen fall within 
the range of that mode's normal mode line #'s then use the 
following procedure: 

a. POKE 87 with the mode # 

b. Determine the Y coordinate by counting the # of mode 
lines from the top of the screen to the current 
position. 

c. Determine the X position in the normal manner for that 
mode . 

d. Depending on the mode, either PLOT and DRAWTO , or 
POSITION and PRINT. 

e. These steps must be done for each mode on the screen 
that meets the condition in step 1. 

example: MODE 1 POKE 87,1 

POSITION 2,1:PRINT #6;"TEXT" 

MODE 7 POKE 87,7 

COLOR 1:PL0T 20,20:DRAWTO 30,30 



MODE 2 See step 2 
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III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES, cont. 



2. Some modes may have mode line #'s outside of their normal 
range . 

example: Mode 2 normally has mode line #'s 1 through 12 

(full screen). These are modified to #63 and 
#64 in example #1. 

To prevent the computer from giving a "cursor out of range 11 
error message the following procedure can be used: 

a. Set a variable labelled ,f MEMST M to be the display 
memory start pointer. 

MEMST = PEEK ( S TART ) + PEEK ( S TART + 1) * 256 

b. Set a variable labelled CHRPOS to position characters 
to be printed on the target line. 

CHRPOS = MEMST + [ (Mi - 1 ) *R-M 2 * (R-2 0 ) -M 3 * (R- 1 0 ) ] +X 
Where: 

X - horizontal position of character on the target 
line . 

R = the RAM per line of the Max RAM Mode (table #1). 

M, ■ the Mode Line # of the target line. 

M 2 = the number of mode lines of 20 bytes of RAM per 

line above the target line. 
M 3 - the number of mode lines of 10 bytes of RAM per 

line above the target line. 

Example: calculate CHRPOS for Mode Line #64 (the 

last line of the Mode 2 area) at horizontal 
position 5. 

X - 5 
R - 40 
Mj =64 

M 2 = 7 (6 from Mode 1 area, 1 from Mode 2 area). 
M 3 = 0 

CHRPOS = MEMST + [ ( 6 4- 1 ) * 4 0- 7 * ( 4 0 - 2 0 ) - 0 * ( 4 0 - 1 0 ) ] +5 
CHRPOS = MEMST + [ ( 6 3 ) * 4 0 - 7 * ( 2 0 ) - 0 * ( 3 0 ) ] +5 
CHRPOS = MEMST + [2520 - 140] + 5 
CHRPOS = MEMST + [2380] + 5 
CHRPOS = MEMST + 2385 



B - 6 - 



/ 
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III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES, cont. 



cont 
c . 



If few characters will be printed, then each character's 
internal value may be looked up in the Internal 
Character Set Table (Table 9.6), 
Reference Manual. This value is 
CHRPOS . 

If strings are to be output, and 
of all the characters lie within 

shown in the table below, then do the following: 

1) Obtain the appropriate ATASCII value range for 
the characters 

Do the OPERATION the table indicates on the 
ATASCII value of each character. 
POKE this value into CHRPOS. 



in the new BASIC 
then POKED into 

if the ATASCII values 
one of the ranges 



2) 
3) 



ATASCII VALUE 



I 



RANGE 


OPERATION 







0-3 1 
32-95 
96-127 
128-159 
160-223 
224-255 



I 



Value + 64 

Value - 32 
NONE 

Value + 64 

Value - 32 
NONE 



Example: 1) 

2) 
3) 

4) 



assume we want to print the word "TEXT 11 
in the mode 2 area of example #1 using 
the CHRPOS calculated previously, 
these characters are in the ATASCII 
VALUE RANGE of " 3 2 - 9 5 11 . 

the OPERATION for this range is "Value-32' 
so 32 must be subtracted from each 
ATASCII value. 

the program statements would now look 
like this: 



T$(l,4) 
CHRPOS 



- "TEXT" 
= MEMS T + 



2385 



FOR X = 1 TO LEN (T $ ) 

POKE CHRPOS + X - 1, ASC[T$(X,X)] - 32 

t t 

(OPERATION: value - 32) 



NEXT X 



5) 



6) 



the FOR/NEXT loop POKEs the first 
character of T$, AS C [ T $ ( X , X ) ] - 3 2 , into 
CHRPOS + 0. 

the next iteration POKEs the next 
character of T$ into the next CHRPOS, 
and so on. 

B -7- 
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TABLE #1 



MODE BYTE 



I 
I 

REMARK | 
I 




LEFT | 
NIBBLE I 
(HEX) | 



I 

I RIGHT 

I NIBBLE 

I (HEX) 



I SCAN | 

C.C.| LINES I 

PER | PER | # 

PIXEL I MODE | COLORS 
LINE 



MODE 



© 



(T^ Left nibble for all mode bytes after the LMS byte. 



Color & Lum for the field is controlled by Setcolor 2, and 
Lum for characters or graphics from Setcolor 1. 



© 

(4^) JUMP - used to end the display list and return to the 

beginning • 



RAM 
PER 
LINE 




When the max RAM mode is not at the top of the screen, the 
left nibble of the LMS byte must be changed to a 4. 



BLANK - to output selected number of background lines. 
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TABLE #2 

GRAPHICS MODES 
RAM REQUIREMENTS 

Mode 8+16 8138 Bytes 

8 8112 

7+16 4200 

7 4190 

6 + 16 2184 

6 2174 

5 + 16 1176 

5 1174 

4+16 696 

4 694 

3+16 432 

3 434 

2 + 16 420 

2 424 

1 + 16 672 



1 

0 



674 
992 



These values include the display list and any imbedded 
unused memory blocks. 
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APPENDIX C: PINOUTS 



Monitor Jack (800 only) 
D.I.N. 5 Jack 



Audio Output- 
Composite Chroma 
Ground 



Serial I/O Jack 




Composite Luminence 



Composite Video 



8 10 12 



1. Clock Input 

2. Clock Output 

3. Data Input 
4 . Ground 

5. Data Output 

6 . Ground 

7 . Command 



11 




8 
9 
10 
11 
12 
13 



Motor Control 
Proceed 
+5/Ready 
Audio Input 
+12 volts 
Interrupt 



Controller Jack 




4 
# 



8 




1. (Joystick) Forward Input 

2. (Joystick) Back Input 

3. (Joystick) Left Input 

4. (Joystick) Right Input 

5. B Potentiometer Input 



6. Trigger Input 

7. +5 volts 

8 . Ground 

9. A Potentiometer 



